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This book is intended to be an introduction to Assembly Language programming 
on the IBM PC, and to provide the Assembly Language programmer with a valuable 
reference for future use. Three subject areas are of interest when writing programs 
for the IBM (and compatible computers). These are: 

1. the 8088 microprocessor, the brain of the IBM; 

2. MS-DOS or PC-DOS, the operating systems for the compatibles and the IBM; 
and 

3. general programming practices, which when applied to Assembly Language 
programming, make the exercise worthwhile. 

You should know how to operate your computer. This book will not instruct you 
on where the on/off switch is located, nor will it tell you how to properly insert a 
diskette and efficiently use DOS commands, such as DIR or COPY. You should 
consult your operations manual if these commands do not sound familiar to you. 


Why Assembly 
Language? 


Assembly Language is capable of creating programs that execute faster and are 
more efficient in terms of memory usage than are most higher level languages, such 
as BASIC. Most people have heard about Assembly Language (AL) and Assembly 
Language Programming (ALP), but few may have already attempted to program 
their machines using AL. 

Assembly Language is intimidating to the novice programmer, but then so are 
numerous other activities when attempted for the first time. 

You’ll find that the skills acquired from learning to program your IBM PC will 
enable you to quickly learn a different microprocessor’s architecture and instruc¬ 
tion set. Once you become really proficient at Assembly Language programming, 
learning a new microprocessor’s architecture and the instructions necessary to 
program it will take about a month. 

The current trend in applications development work is to use higher level lan¬ 
guages, such as BASIC, FORTH, and Pascal, to reduce programming time. How¬ 
ever, most applications require some portion of the application program to be 
written in Assembly Language (AL). 











High level languages such as BASIC and COBOL do speed up development time, but 
they do not execute as quickly as programs written in AL. Higher level languages 
also require more memory than programs written in Assembly Language. 


Getting to Know 
Your Micro 


Perhaps the most important concept any book on Assembly Language Program¬ 
ming (ALP) must convey is that you, the programmer, will become acquainted with 
the hardware that makes a computer a computer. This knowledge is essential when 
writing in Assembly Language. You must know the microprocessor’s architecture, 
its registers and instructions. 

As this book is about 8088/IBM ALP programming, you should have access to an 
IBM PC or one of the compatible computers with a minimum of 64K memory, two 
disk drives, PC-DOS or MS-DOS 2.0, the IBM Macro Assembler (IBM part number 
60242002), and, optionally, a full screen editor or word processing software 
package such as WordStar from MicroPro Inc. The line editor EDLIN, which comes 
with PC-DOS, can be used to enter the source examples given in the text; however, 
a full screen editor will make source entry and editing easier and faster. 

All the examples in this book were developed under MS-DOS 2.0, a system with 
256 k of RAM, two disk drives, and the Macro Assembler from IBM. The examples 
themselves are simple enough for first time ALP programmers. Should you want to 
experiment by using different or more sophisticated programmi n g examples, by 
my guest. It is the only way you’ll become proficient in writing your own pro¬ 
grams. 


ALP 


A language is nothing more than a form of communication; a vehicle through 
which ideas, concepts, and actions are expressed. Suppose for a moment that you 
speak the language known as English, and you are trying to communicate in 
Spanish. Without knowing the language you can make grandiose gestures, draw 
pictures, or try some other form of audio/visual maneuvering to convey your 
meaning. The easiest solution is to find someone who speaks and understands both 
languages, English and Spanish. If the translation process goes smoothly and 
correctly, your meaning will be conveyed to the other party. 

Similarly, when you program in AL, you program in the language of the assembler. 
What you type or enter from the keyboard is a language unique to the assembler for 
a particular microprocessor. The assembler statements are referred to as source 



code. The hitch is that the computer understands what is known as machine code, 
which is in the form of binary ones and zeros (more on binary in Chapter 1). You are 
faced with a similar problem; you need a translator. 

The assembler translates your source program into a machine readable format that 
the computer can understand and execute. Should you mistype or misspell an 
entry, the assembler usually generates an error message. If, however, you enter a 
valid statement, but the statement is not what you intended, the assembler will not 
generate an error messsage, and the error may not be found until you try to run the 
program. The intent is not translated properly; only the process described in your 
Assembly Language source statement is translated. 

This translation process is what must occur whenever you program in Assembly 
Language. The assembler translates your source programs into what is known as 
executable or object code; the binary ones and zeros the microprocessor under¬ 
stands. 


The Definition of NEW 


Learning AL does not happen overnight, nor does it occur through osmosis. 
Whenever you write a NEW AL program, remember that NEW is an abbreviation 
for Nothing Ever Works the first time. You will most likely find that a few bugs 
have crept into your program. These errors are common to all programmers and 
not restricted to just the beginner’s code. More often than not your logic will be 
correct, but you’ll have made a syntactical error that the interpreter translated 
literally when translating your source code. 

There is one bright note in making mistakes; you learn from them. After spending 
considerable time poring over a section of code to find an error, you’ll find 
yourself quickly learning and understanding the code in its entirety. While the 
program examples in this book have been debugged for you (by yours truly). I’m 
sure that a few typos will creep into your program as you enter the programming 
examples. 


Hardware 


While it is important to understand the hardware in your PC, I will limit my 
discussion to the microprocessor (8088) and a few of the support chips found in 
the PC. I will not go into a great amount of detail, as it is not the purpose of this 
book to delve into hardware specifics about the machine. The section will be more 
to introduce you to the world where Assembly Language programs must directly 
deal with such devices and program their operation. The main thrust of this text is 
to demonstrate how programs are written in the PC-DOS environment. 
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This implies that the operating system is responsible for initializing the support 
chips and in carrying out Input and Output (I/O) through these chips. The advan¬ 
tage inherent in presenting an introduction to ALP in this manner is that the 
programs you write will be transportable to another MS-DOS or PC-DOS IBM 
compatible computer. Should you attempt to directly program these chips, you 
may find that the physical memory or port address where they reside is not the 
same in all computers, even though the computers are said to be compatible. 

Once you feel comfortable programming the PC, you’ll be ready to learn more 
about programming hardware devices such as a communications interface chip 
(Intel’s 8251A), a programmable timer such as the Intel 8253, or a peripheral 
interface chip such as the Intel 8255. 



Chapter 1 is an introductory chapter describing the different numbering systems 
used in assembler programming. Chapter 2 is an introduction to concepts that 
apply to all microprocessors and assemblers. Towards the end of the chapter I’ll 
begin to focus directly on the 8088 microprocessor with a programming example 
that represents your first AL program (if you’re new to ALP, of course). 

Chapter 3 looks at the 8088 architecture in detail. Registers and their usage are 
defined and programming examples provided. Chapter 4 discusses the instruction 
set of the 8088 and the manner in which data are accessed (addressing modes). 

Chapter 5 discusses features of the IBM Macro Assembler, MASM. The main empha¬ 
sis of this chapter is using the many advanced features of the IBM Macro Assembler 
to control the assembly process. Chapter 6 describes MSDOS and macro instruc¬ 
tions in detail: What they are and how to use them. A complete macro library is 
included on the diskette that accompanies this book. The macro library contains 
macro definitions for all of the functional calls supported by MS-DOS 2.0. Many 
BIOS macros have also been included. 

Chapter 7 demonstrates how a program is written from start to finish. Chapter 8 
discusses disk programming. The chapter contains four programming examples, 
including a program that reads, sorts and displays all filenames found in a diskette’s 
directory. 

Chapter 9 focuses on BIOS, the Basic Input/Output System of the PC. Programming 
examples include graphics and sound routines. Chapter 10 discusses telecom¬ 
munications and presents an interrupt driven telecommunications program. The 










program supports disk and printer spooling while on-line and communcation baud 
rates up to 9600 baud. 

For those of you who are experienced at writing AL programs for the 8088, you 
may want to skip directly to Chapters 6 through 10, which provide the necessary 
information required to write AL programs on the PC. All the information neces¬ 
sary to write programs that accept data from the keyboard, disk, and other I/O 
devices is presented here. There is also information on the operating system, MS- 
DOS, in these chapters. 

I hope you find this book instructional and refer to it from time to time as one of 
your reference books on the IBM PC. Should you wish to communicate with me, 
you can write me: 

do Argonaut Systems 
POB 2492 

Northbrook, IL. 60062 

Please include a self-addressed stamped envelope if you expect a reply. You can 
also leave me electronic mail on CompuServe. My user I.D. number is 71625,121.1 
hope to hear from you. 


XV 



It would be nice to have a computer that understood every word (spoken or typed), 
interpreted its meaning, and understood our numbering system. If that were the 
case, programming would be a snap. Nearly anyone could walk up to the machine, 
put it into a learning mode, and program it in plain English. If this were the case, 
there would be no need for this book or others like it. However, these are the 
machines of the future, ones that today’s science fiction is made from. 

Current technology is available that allows machines to talk and to listen to the 
spoken word. However, these voice input and output devices, like the printer or 
disk drive attached to your computer, receive and transmit information to and 
from the computer system via two discrete voltage levels. The voltage is either ON 
or OFF. 

For the time being, computers understand only electrical signals that are either on 
or off. The language the computer understands is in binary form, the base two 
numbering system. Therefore, it is imperative that you understand binary and 
other numbering systems that are commonly used in programming, before you 
begin to look at Assembly Language programming on the PC. There is not one 
programming application that I can think of where a basic understanding of the 
different numbering systems is not important. 

I’ll examine numbering systems in this chapter and how data are represented using 
binary and hexadecimal notation. A later chapter provides you with a program that 
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can be run on the PC to convert values among the decimal, binary, and hex¬ 
adecimal numbering systems. 



Binary (Base 2) 

Humans chose a numbering system for their everyday use that was convenient to 
them—decimal, or base 10. As humans have ten digits (10 fingers), we chose a 
numbering system which also has ten digits—0 through 9. This is convenient for 
humans, but a microprocessor understands only the presence or absence of an 
electrical signal. 

Since the microprocessor is concerned with only two possible states (ON or OFF), 
the binary numbering system could be used to represent the two possible states as a 
binary 1 for the ON condition and binary 0 for the OFF state. 

This is the smallest amount of binary information in a digital system, and it is 
referred to as a BIT (Binary digiT). Several bits are usually grouped together to 
convey more information than can be found in a single bit. When 8 bits are grouped 
together, a byte is formed. A word is a grouping of the maxim um number of bits the 
microprocessor can store internally. For the 8088, a word consists of 16 bits, the 
maximum width of any 8088 register (an internal storage location). 

Counting in Binary — 

Examine for a moment how a decimal number is constructed. The number three- 
hundred-and-thirty-five is represented in decimal as 345. There is a one’s position, 
a ten’s position, and a hundred’s position. Each digit’s position is a multiple of the 
numbering system’s base. The first position is 5 x 10 raised to the 0 power. The 
next digit has the significance of 4 x 10*. The hundred’s digit is expressed as 3 x 
102. Each successive digit’s significance is increased by a factor of ten. 

Similarly, the binary number 10000111 represents the decimal number 135. The 
bit positions take on the following significance: 
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MSB (Most Sign! 

b7 bS bS b4 

1 0 0 0 

laa 64 32 16 

7 6 5 4 

2 2 2 2 


fint Bit) 

b3 b2 bl b0 

0 111 

6 4 2 1 

3 2 10 

2 2 2 2 


USB (Ueast 

Binary 

Decimal 

Powers of two 


Significant Bit) 


The decimal values for all bit positions containing a 1 are added together to arrive at 
the decimal number being represented. A byte of all ones would equal the decimal 
value of 255. Since a byte of all zeros is possible, there are 256 total bit combina¬ 
tions possible within a byte (8 bits). What would the decimal value of the binary 
number 10101010 be equal to? Figure 1-1 shows the bit significance in a byte. 


Bit Significance In a Byte 






BYTE 





High Order Nibble 

Low Order Nibble 

Hexadecimal Weight — 

8 

4 

2 

1 

8 

4 

2 

1 

Decimal Weight — 

128 

64 

32 

16 

8 

4 

2 

1 

Binary Weight - 

27 

26 

25 

24 

23 

22 

2^ 

29 

Bit Position — 

B7 

B6 

B5 

B4 

B3 

B2 

B1 

BO 

Byte#1 

0 

1 

0 

1 

0 

0 

1 

0 

Byte #2 

1 

1 

1 

1 

0 

0 

0 

0 

Byte # 1 (decimal) = 

0 + 64-k0-l-16-l- 
which equals 52 HEX 

0 -1- C 

1 + 2 

+ 0 

= 82 

Byte #2 (decimal) = 

128 + 64 -H 32 -H 16 -k 0 0 -1- 0 

which equals FO HEX 

-1- 0 = 

= 240 


Figure 1-1 A total of 256 possible states may be represented in a byte of binary. Shown are two 
bytes of binary. Notice that to represent the byte in hexadecimal, the byte is divided into 
two 4 bit quantities known as “nibbles”. 


Table 1-1 shows the binary numbers for 0 through 255 decimal. Notice that each 
time a bit position that is already set to a binary 1 has one added to it, the digit 
changes to zero. A carry is generated into the next bit position. This occurs in 
decimal also. It happens whenever 1 is added to 9: 

9 + 1 = 1«, 39 + 1 = 4®, 99 + 1 = 100 etc. 
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Table 1-1 

8 Bit Binary Examples 

Decimal 

Binary 

Hexadecimal 

0 

00000000 

OOH 

1 

00000001 

01H 

2 

00000010 

02H 

3 

00000011 

03H 

4 

00000100 

04H 

5 

00000101 

05H 

6 

00000110 

06H 

7 

00000111 

07H 

8 

00001000 

08H 

9 

00001001 

OOH 

10 

00001010 

OAH 

11 

00001011 

OBH 

12 

00001100 

OCH 

13 

00001101 

ODH 

14 

00001110 

OEH 

15 

00001111 

OFH 

16 

00010000 

10H 

250 

11111010 

FAH 

251 

11111011 

FBH 

252 

11111100 

FCH 

253 

11111101 

FDH 

254 

11111110 

FEH 

255 

11111111 

FFH 


Adding numbers in binary is just as straightforward. 


hi 

b& 

b5 

b4 

b3 

bS 

bl 

b0 

Decimal 


1 

1 


1 

1 

1 

1 

Carries <- = no carry) 

0 

0 

0 

1 

1 

0 

1 

1 

27 

+ 1 

0 

1 

1 

1 

0 

1 

1 

+ 187 

1 

1 

0 

1 

0 

1 

1 

0 

214 
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Bit 1 (bl) in each of the two values to be added is set to binary 1. When they are 
added together, they produce binary 0 and generate a carry out of bit 1 into bit 2. 
But the carry into bit 1 from the previous addition (bO) must also be added. After 
adding the carry bit to the binary ones occupying the bl position, the result is 
binary 1, with a carry into the next bit position, b2. 


Binary Subtraction — 

To subtract two binary numbers, the concept of two’s complement notation must 
be introduced. In the previous discussion, I spoke only of 8-bit unsigned numbers, 
with a range of 0 to 255. I’ll now introduce the manner in which signed numbers, 
positive and negative, are represented. If you’re concerned only with unsigned 
numbers, all eight bits of a byte or all sixteen bits of a word are available to 
represent a given value. If you want to add -I- 3 to -1, that is to say subtract 1 from 
-1-3, the value of -1 must be represented within the 8-bit data field. This is 
accomplished by using the MSB of the data field to represent the sign bit. For byte 
values, a 1 in the MSB position indicates that the value of bO through b6 is negative, 
while a zero in the MSB indicates that the value is positive. 

Since the sign bit occupies one bit position, there are only seven bits (fifteen bits for 
a word) left to hold a binary value. Therefore, the range of signed values that can be 
represented in a byte is: 

Positive Values Negative Values 

00000000 (decimal O) llllllli (decimal -1) 

to 

01111111 (decimal h- 1£7> 1 OOOOOOO (decimal -I'cLQ) 

It is often convenient to depict positive and negative ranges by using a number line 
as follows: 


8-Bit Byte Values 

0.128.256 

-128.0.+127 

16-Bit Word Values 

0.32, 768.65, 536 

-32, 768.0.+32, 767 


Unsigned Binary 
Signed Binary 

Unsigned Binary 
Signed Binary 


I can hear you saying, ‘ ‘How the heck does a byte of binary one’s equal minus one?” 
Negative numbers are represented in what is known as two’s complement nota¬ 
tion. To perform a two’s complement on a binary number, flip all the bit positions 
and add a binary 1. If the bit position was a 1, change it to zero. If the bit position 
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contained a zero, change it to 1. This forms the one’s complement of the binary 
value. Do this for all the bit positions and add 1 to the result to form the two’s 
complement. Actually, the value to be converted is subtracted from zero to form 
the two’s complement, but complementing the number and adding 1 also works. 
The following example illustrates how this is done. 

Number to convert: 0010001 1 (35 decimal) 

One’s Complement: 11011100 

Md a binary 1: 11011101 (-35 decimal) 

(Form 2’s complement) 

To discover what negative number a signed binary field contains, perform a two’s 
complement on the number as follows: 

Unknown V/alue: 10110101 (-? decimal) 

Complement: 01001010 

Add a binary 1: 01001011 75 decimal (Negative 75) 

Convert binary to decimal - >> -(64 + 8 + £ + l) 


By representing negative numbers in two’s complement, a subtraction is carried out by 
adding the two values: (+A) + (- B). Let’s say I want to subtract 2 from 1.1 would first 
perform a two’s complement on the subtrahend, then add that value to 1. 


1) Convert *^-2 to -2 
Subtrahend: 
Complement: 

Add 1 : 

2) Add -2 to 1. 

Subtrahend: 


00000010 (- 4 - 2 ) 

1111110 1 
11111110 (- 2 ) 

00000001 ( + 1 ) 
'►11111110 (- 2 ) 


11111111 (- 1 ) 


Check the answer by performing a two’s complement on the result, keeping in 
mind that when the number is read, it has a negative magnitude. 
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Result 8 
Complement s 
Add 1 8 


1 1 1 1 1 1 1 1 <~ 1 ) 

00000000 

0000000 1 The value is 1 (negative) 


A byte of all I’s is equal to a -1, and all subtractions can be carried out through 
addition. 


Converting Decimal to Binary 


To convert a decimal value to binary, divide the decimal value by 2. Write down 
the remainder. If the quotient is zero, you are finished with the conversion. If the 
quotient is not zero, repeat the process using the quotient as the dividend. 

For example, convert 137 to binary: 


Step 


Quotlent 


Remainder 

1) 137/2 

* 

66 

1 


Least 

Significant Bi1 

2) 66/2 

= 

34 

0 



1 

1 

3) 34/2 

- 

17 

0 



1 

1 

4) 17/2 

- 

a 

1 



1 

i 

8/2 


4 

0 



1 

i 

6) 4/2 

= 

2 

0 



1 

1 

7) 2/2 

s 

1 

0 



1 

1 

6) 1/2 

= 

0 

1 


Most 

1 

Significant Bit 

The binary representation of 137 is: 


MSB <- 




— 

LSB 


B7 B6 

BS 

B4 B3 

B2 

B1 

B0 


1 0 

0 

1 0 

0 

0 

1 

BINARY 


Hexadecimal Numbering 

(Base 16) 


I have purposely limited the discussion on binary values to byte-wide data fields to 
keep the values used in the examples small. Binary notation is very inconvenient 
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when larger values must be represented. A l6-bit value of 2498 decimal would be 
represented as 0000100111000010. It’s harder to read and harder to work with large 
numbers in binary form. The number can better be represented using a numbering 
system that retains some similarity to the bit positions of the data field. Decimal 
does not meet our requirements, as there is no direct correlation between the 
decimal and binary digits. 

Hexadecimal is most often used to represent binary data. Hexadecimal digits are 
comprised of the digits 0-9 and A-F. By dividing the data field into 4-bit slices 
called NIBBLES, you can represent a l6-bit binary number with four hexadecimal 
digits, and an 8-bit number with two hexadecimal digits. The decimal weights 8,4, 
2,1 are given to each bit position of the nibble. If a nibble’s value exceeds 9, the 
letters A-F are used to represent the decimal values of 10-15. 

The number 2498 decimal is represented in binary and hexadecimal as follows: 


0 0 0 0 

10 0 

1 

110 0 

0 0 1 

0 

Binary 

a 4 a i 

i i 1 i 

8 4 2 
i 1 i 

1 

1 

8 4 2 1 
till 

8 4 2 

I 1 i 

1 

1 

NIBBLE bit values 

\i/ 

\ i7 

J 

\l7 

\l/ 

.1 


0 

9 


C 

2 


Hexadecimal 

3 

2 


1 

0 



16 

16 


16 

16 


Powers of 16 

0 X 4096 

+ 9 X 

258 

+ 12 X 16 

-*■ 2 X 

1 = 

Decimal 2498 


The hexadecimal representation is therefore 09C2H. The H suffix denotes that the 
number is expressed in hexadecimal notation. In Chapter 7, I’ll show you how to 
write a program which accepts decimal input from the keyboard and converts the 
number to hexadecimal and binary and displays the result on the video screen. 

When hexidecimal notation is used in your source program, you’ll need to 
remember this next rule. When the hexadecimal digit begins with a letter (A-F), 
you must precede the number with a zero. For example, if you wanted to use the 
hexadecimal number FADEH, the assembler would not be able to determine 
whether the characters represented a constant or a name. The leading Zero informs 
the assembler tO treat OFADEH as a number and the lack of a leading zero (as in 
FADEH) informs the assembler that the characters reprfesent a symbolic name. 


Addition of Hexadecimal 
Numbers ' ,. " 

As in the binary and decimal numbering systems, hexadecimal digits can be added. 
When the addition exceeds a digit’s capacity, the digit rolls over to zero and a carry 
is generated into the next digit position. For example: 
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1- 

< <--CCarrieB> 

9FC0 H 


+ 1938 H 

< <- 1 

B8Fa H 

<<-{Result> 


Binary Coded Decimal 


Often you need to store and work with numbers in a computing system that are 
encoded in Binary Coded Decimal, BCD. BCD uses 4 bits to represent the decimal 
digits 0-9. A byte can therefore contain two packed BCD digits. If a byte contains 
only one BCD digit (unpacked), the other nibble must be zeroed. For example: 

Unpackea BCD Packed BCD 

00130 0010 = a (BCD) 1001 0001 = 91 (BCD) 

0000 1001 . 9 (BCD) 0110 0111 » 67 (BCD) 

The following are illegal representations: 

0000 0010 = 0tt H - Is not a digit 0-9. 

1110 1100 = EC H - Neither nibble is a digit between 0-9. 

Since BCD is used to represent the decimal digits 0-9, any 4-bit combination in 
excess of the decimal value 9 cannot be considered a valid BCD digit. 

BCD Addition-—- 

When the microprocessor adds numbers, it treats all values as binary. It does not 
know or care if the binary values being added are BCD encoded or in some other 
encoded format. The (computer adds the BCD digits just as if they were binary 
numbers, as follows: 


0101 

0011 

= 53 

BCD 

•C83 

decimal 

(Binary weight)> 

+ 0010 

0110 

» EG 

BCD 

■C38 

decimal 

(Binary weight)> 

0111 

1001 

= 79 

BCD 

■C 53 

; + 26 = 

79 BCD > 


■ClEl decimal (Binary weight) > 
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The answer is correct: 

0011 0111 = 37 BCD <55 decimal (Binary weight)> 
0011 0010 = 3£ BCD <50 decimal (Binary weight) > 

0110 1001 * 69 BCD < 37 + 32 * 69 BCD > 

<105 decimal (Binary weight)> 

The answer is not correct: 

0011 1001 = 39 BCD <57 decimal (Binary weight)> 
+ 0011 0001 * 31 BCD <49 decimal (Binary weight)> 


0110 1010 « 6ftH <N0T A VALID BCD DIGIT‘> 

<6Ah= 106 decimal (Binary Ueight)> 

The reason this last example is not a valid BCD digit is that the low order nibble 
produced a binary combination in excess of 9. What it all means is that there has to 
be a method to correct for such a condition. What would happen if you added 6 to 
the low order nibble that was in error? Let’s see what result this would produce. 

The original addition was to produce a result of 70 in BCD format (39 + 31). The 
actual result was 6AH. 

0110 1010 = &AH 

Nom add 6 —>> 0000 0110 - 06 'CBCD> 


0111 0000 o 70 <BCD> 

The answer is now correct, and it is represented in a BCD format. The rules are 
simple. If the result of a BCD operation produces a value in excess of 9, add 6 to the 
result to correct the result to proper BCD format. There is still one more case to be 
considered. What would happen if the result of the addition produced a nibble 
whose value has passed right through the range of 10 to 15, which is not allowed? 
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Consider the following: 

0000 1001 = 09 <BCO> 
+ 0000 1001 « 09 <BCD> 


0001 0010 « IS <?> 


The result looks like BCD, but it isn’t correct. We passed through the range 
necessary to effect an adjustment of the nibble, when the nibble’s value exceeds 10. 
The former rule cannot apply since 2 is less than 10. However, there has been a 
carry generated out of the low order nibble (bit 3) into the first bit position of the 
high order nibble. 

Let’s qualify the former rule: Whenever the result of a BCD addition causes a digit’s 
value to exceed 10, OR when a carry is generated out of a nibble due to the addition, 
add the value of 6 to the nibble to correct the result. When this is done, you obtain 
18 BCD, the desired result of 9 plus 9. The important point to remember is that the 
CPU does not know or care if the number to be added is in BCD format. To the CPU, 
all forms of character encoding appear in binary form. Therefore, it is the program¬ 
mer who makes the distinction of how the arithmetic should take place and what 
graphic characters and numbers the binary groupings are to represent. 



ASCII 


In an attempt to standardize and formalize the manner in which computers 
exchange information, a method to encode alphabetic, numeric, and special char¬ 
acters was devised. ASCII (American Standard Code for Information Interchange) 
is a 7-bit code that defines the individual bit groupings for each letter of the 
alphabet and the ten numeric digits defining the decimal numbering system. 

The eighth bit is used to transmit parity, a form of error checking that is dependent 
on the total number of binary Ts contained in the character transmitted. If the total 
number is even, and you are using even parity, the eighth bit is zero. If the total 
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number is odd, the eighth bit is set to 1, to make the total number of 1 bits an even 
number. 

In total, there are 128 different bit groupings (T = 128) assigned to represent 
character, number, and special character graphics as well as special control codes. 
The control codes are used to control how the communication between two 
computing devices takes place. For example, the binary bit combinations of 001 
0001 (DCl = IIH) and 001 0011 (DC3 = 13H) are commonly used to resume or 
suspend communications between two devices. These controls are commonly 
referred to as XON and XOFF, for transmit on, or transmit off. 

Although the programmer determines how the bit combinations the computer is 
acting upon at any given moment are to be interpreted, ASCII was developed to 
insure a standard means of transferring information between computing devices. 
In other words, if I know before computer-to-computer communication begins, 
that your terminal will be transmitting ASCII text to mine, and I receive the bit 
combination 100 0001 (41H), I know that the bit combination will always be used to 
represent the letter A. Similarly, if 1 transmit the bit combination of 011 0011 (33H) 
to your terminal, you will always interpret this bit combination as the character 3. 


Other Binary Codes 


This would be fine if ASCII were the only coding used to represent letters, 
numbers, and special characters, but it is not. There are other binary codings which 
are used in international and mainframe computer communications. EBCDIC 
(Extended Binary Coded Decimal Interchange Code) is widely used in the IBM 
mainframe world. EBCDIC (pronounced EB-SID-IC) is an 8-bit code used to repre¬ 
sent control, alphabetic, numeric, and special characters. The EBCDIC code can be 
found in Appendix A. 


Baudot Code 


Baudot is another binary code used to communicate information between 
machines. Baudot is commonly found in international and domestic communica¬ 
tions involving telegraph circuits. It is a 5-bit code that is usually associated with 
teletypewriters and teleprinters. Typically, these devices have limited commu¬ 
nications speed (usually less than 110 bits per second). By using only 5 bits to 
encode a character rather than the 7 bits required in ASCII or the 8 bits required in 
EBCDIC, characters are transferred between communicating equipment faster. 
The Baudot character set can be found in Appendix A. 

I’ll discuss ASCII and other binary codes further when I explain the 8088’s instruc¬ 
tion set. The 8088 microprocessor has some powerful instructions that benefit the 
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Assembly Language programmer who must work with ASCII and BCD characters 
or strings. But for now, let’s turn our attention to the language of assembler. 



1. The role of an assembler is to_a_file into an object 

file. 

2. In binary there are_possible states: 

_and_. 

3. The computer subtracts two binary numbers using_comple¬ 

ment notation. 

4. Give the one’s complement form of the following binary numbers: 

A. 0 10 10 110 C. 10 111110 

B. 11110000 D. 01010101 

5. What is the two’s complement of the binary numbers in problem 4? 

6. Convert the following binary values to hexadecimal notation: 

A. 10011110 C. 11111111 

B. 11100111 D. 1000110000001111 

7. Convert the following hexadecimal numbers to binary: 

A. OFFAIH B. 2078H 

C. 7FFCH D. 0003H 

8. Why does the hexadecimal number in 7A above contain a zero prefix? 

9. Two popular types of character encoding are _ and 

10. The base of each numbering system is: 

A. Binary is base_. 

B. Hexidecimal is base_. 

C. Decimal is base_. 

11. What is wrong with the following hexadecimal number? 

0FG77H 












This chapter introduces novice programmers to the discipline required to be an 
Assembly Language (AL) programmer. Many new programmers feel that there is 
something mystical about learning to program in Assembly Language. If there were 
something mystical about the language, I’m sure more programmers would be 
named Merlin. Since I know only one programmer who calls himself Merlin, and 
his programs are far from being mystical, it is safe to assume that most of us mere 
mortals who really have the desire to program in Assembly Language will be able to 
do just that by the end of this book. 

Like all good things worthy of personal possession, the skills required to become 
an AL programmer are not acquired without a certain degree of frustration. 
However, the rewards can be considered substantial, in personal enjoyment and 
financially, if you are so inclined. 


15 
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The fallacies surrounding ALP are as numerous as those surrounding the program¬ 
mer. A typical characterization is as follows: ALP programmers must possess a high 
degree of mathematical skills, and they must also hold higher level degrees. They 
are hermits who let nothing stand in the way of finishing the project at hand, 
knowing full well that software projects are rarely finished, they are merely 
released. 

If married, you have to pity the poor spouse of the AL programmer. Dinner 
conversations revolve around bits and bytes, algorithms and code. Shopping with 
such an individual can be almost as exciting, as every book store is an invitation to 
“keep current” with the technology. Computer stores are sought out with a most 
unhealthy, if not obnoxious zeal. 

Contrary to the stereotype presented, a higher level degree and advanced mathe¬ 
matical skills are not required for an individual to become proficient at AL pro¬ 
gramming. Although the skills certainly wouldn’t hurt, they are not required. 
When an application requires a tremendous amount of computational power, the 
program is usually written in a high level language such as FORTRAN (FORmula 
TRANslation language). It’s rare when such an application would be coded totally 
in Assembly Language. 

As for the AL programmer being a hermit, nothing could be further from the truth. 
Most commercial software projects are developed by a team of software engineers 
in a team environment. An individual programmer has responsibility for a specific 
portion of code which is later incorporated into a main program consisting of the 
modules and subprograms created by the other individuals. The team is usually 
composed of specialists. There may be one individual who is proficient at data 
communications while another is concerned with internal data structures or the 
user interface. 

Obviously, if you are programming your own personal computer, you will most 
likely be doing so without the aid of other programmers; hence, the purpose of this 
book. Books are often your only resources when working on a section of code. The 
modular programming concepts of a program written in a team environment still 
apply. However, you are the one who is responsible for writing all the modules 
which ultimately become the finished program. 

Those who do become proficient at AL programming tend to view the world and 
problems in a somewhat different perspective than those engaged in other profes¬ 
sions. The reason may be traced to the extremely logical thought process forced 
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upon the AL programmer by the very nature of his/her chosen career. There is a 
tendency to apply that logic to the world and those around us. The unobvious 
becomes the obvious, and problems become puzzles which are challenges to solve 
and master. It is all a matter of attitude and a learned set of skills. 

One thing to keep in mind is that you cannot program the computer in any 
language, if you yourself do not understand the application. If you cannot explain 
the problem and define a method to arrive at the solution, the computer will be of 
little help. You can be the most creative and productive programmer on your block 
and not be able to write the program for a problem beyond your own expertise. 

For example, if you have never flown an airplane, it would be very difficult if not 
impossible to write a believable flight simulation program. For someone else who 
is involved with aviation and who can program in Assembly Language, writing 
such a program will be easier than for most of us. This is what makes programmers 
so valuable; it is not that they know how to program in Assembly Language, but 
rather that they understand an application and can define its solution through 
Assembly Language. 



Once you master the assembler’s language for one microprocessor (also referred to 
as a CPU, or Central Processing Unit), you’ll be able to transport your skills to a 
different microprocessor. The process does require learning, a new architecture 
(registers, status flags, etc.) and a new instruction set; however, the basic and 
fundamental concepts of programming in assembler apply to any microprocessor. 
For example, to load the accumulator of the 8-bit 6800 (Motorola) with a decimal 
value of 16, you would enter the following statement into your source program: 

LDAA # 16. The Zilog Z-80 CPU requires LD A,l6. To accomplish a similar function 
on the 8088/86 CPU, you would type: MOV AL,l6. Notice that one micro¬ 
processor’s assembler requires the instruction LD (LoaD), and the other requires a 
MOVe instruction. The difference between these particular instructions is trivial 
and easily learned. Other instructions may not be so obvious and may require 
closer inspection. 
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A computer language can be classified as either being a high level language, such as 
BASIC, FORTRAN, COBOL, or Pascal, or a low level language, such as Assembly 
Language. The classifications can be further refined as to whether a high level 
language is interpretive or compiled. Programming languages exist only as an aid in 
describing the steps necessary to solve a problem or a set of problems. Ultimately, 
all but the interpreters produce the machine code the computer understands, and, 
as such, they require a compromise as to the execution speed and the size of the 
machine code each will produce. 


Higher Level Languages 


The assembler represents a quantum leap over programming a machine directly in 
machine language, yet the human interface is still lacking. It’s more desirable to 
increase a programmer’s efficiency by providing a programming language that uses 
English-like statements to define the problem you want to solve. This is beneficial 
for several reasons. 

First and foremost, the programmer could be isolated from the hardware specifics 
of the machine and not be required to learn a thing about what’s “under the hood” 
of the computer. It’s a little like the old adage of not having to be a mechanic to 
know how to drive a car. 

“Who cares about the registers anyway? Why should I care about an AX or BX or 
XYZ register when all I want to do is print ‘Hi Sue, HAPPY BIRTHDAY! I Love You’ 
on the screen of my computer?” You might ask. Actually, there is no reason to 
learn Assembly Language to have the computer print a simple message on the 
screen. The simple BASIC statement: PRINT “Hi Sue, HAPPY BIRTHDAY! I Love 
You.” accomplishes what will take perhaps hundreds of Assembly Language state¬ 
ments to do—display the message on the screen of the computer. By using a high 
level language, you are isolated from the hardware specifics of the system. This 
allows you to concentrate on solving applications problems. 


Interpretive Languages 


An interpretive language, such as the BASIC interpreter supplied with many home 
computers, must interpret each program statement prior to executing it. Is it a valid 
statement? Is its syntax correct? After properly identifying the statement as valid. 
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the actual code which performs the statement’s function is executed. However, it 
must be noted that this interpretation occurs each and every time the statement is 
executed. Due to the overhead involved, programs execute slower than compiled 
programs or Assembly Language programs. 

The interpreter occupies memory along with the application program being run. 
Because both the interpreter and the application program must be in memory at the 
same time, the physical size of the program is also greater than one written in AL. 


Compiled Languages 


Compiled languages fall somewhere between interpreted languages and Assembly 
Language, in that compilers take on certain characteristics of both. Source pro¬ 
grams are written in a high level language and translated (much like Assembly 
Language) into machine code by the compiler. The object code generated by the 
compiler tends to execute faster than an interpreted program, but it may not be as 
fast as a program written in Assembly Language. The program’s size is, in most 
cases, smaller than that of an interpreted program, yet is larger than a similar 
program written entirely in Assembly Language. Compilers exist for a variety of 
languages, such as BASIC, FORTH, Pascal, COBOL, and the C language. 

With the many language options available, you may still find it difficult to find a 
language to efficiently solve all problems in a given application. The reason is that 
no one language suits all applications. FORTRAN is useful in solving scientific 
oriented problems. COBOL is widely used in business applications. Pascal’s claim 
to fame is that it forces a programmer to use structured programming techniques 
and is of great use in teaching these concepts. BASIC is of interest because it is 
widely used and is usually the first computer language an individual learns to 
program in. For real-time applications where execution speed and memory conser¬ 
vation are of prime consideration. Assembly Language is the choice. 


Machine Language 


When computational machines were first conceived, there were no languages that 
the machine’s programmer could use to instruct the machine what it should do. 
Therefore, each command or machine instruction had to be manually entered. The 
process was slow, tedious and extremely error-prone. 

Machine language is composed of definite digital patterns of binary one’s and 
zero’s: 

Machine Language 


10110100 00001001 


Assembly Language 
MOV AH, 9 
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In the above example, machine language, the language a microprocessor under¬ 
stands, is composed of finite combinations of binary ones and zeros. The micro¬ 
processor decodes these patterns, and performs the specified function. In this 
example, the internal register AH (a storage location inside of the 8088) is loaded 
with a value of 9 decimal. 

A grouping of 8 Binary digITS (BITS) is referred to as a byte of information. A 
grouping of 2 bytes, or 16 bits, is referred to as a word. A typical microprocessor 
sequentially fetches these binary values from memory and decodes them into 
meaningful instructions. As each pattern represents a particular instruction to the 
microprocessor or data which is required by the microprocessor to properly 
execute the instruction, it is extremely important that the binary values be placed 
in memory and remain in memory without alteration. 

For example, the MOV instruction used in the previous example might appear in 
memory as a binary sequence of bits: 

101 1010000001001 
Bit * b7 b& bS b4 bS bB bl b0 b7 be bS b4 b3 bS bl b0 
1st BYTE End BYTE 

This sequence of bits tells the microprocessor to MOV the value of 9 into the AH 
register of the microprocessor. The machine language program sample shown 
below depicts a short program as it would appear in memory and in binary form. 
Should a bit be lost from the machine instruction, either the value moved to AH will 
change, or the instruction itself will change (it will be decoded as a different 
instruction) and render your program useless. It is very important that each 
instruction be entered into the machine accurately. 

101110010000000000011000 MOV CX,E4 

111010000000000100100010 CLSi CALL CRLF 

1110001011111011 LOOP CL8 


Only the binary one’s and zeros are stored in memory, not the English-like abbrevi¬ 
ations to the right. The routine above is part of a larger program used to clear the 
video display of the IBM. Imagine if you had to enter each one and each zero of the 
larger program (see Listing 2-1) into memory manually! 

As each machine instruction directly causes an action to be taken by the micro¬ 
processor, machine language programs execute the fastest of all language types. 
The speed at which an instruction executes is of great importance in many time- 
critical applications and is dependent on the system clock that drives the micro- 
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processor (Figure 2-1), and the manner in which the microprocessor’s designers 
chose to decode a given instruction. Similar instructions executing on different 
microprocessors running at the same speed do not always execute in the same 
amount of time. 





.12 


13- 


-14- 


tx = 200 nanoseconds minimum 
500 nanoseconds maximum 


Figure 2-1 The syslem clock provides a regular “hearlbeal” lo Ihe micro¬ 
processor. The clock is provided by anolher inlegraled circuil (1C), 
an Inlel 8284 clock generalor. 


As a finished program can contain hundreds or thousands of machine instructions 
to solve a given problem, it would be a very tedious chore to code your program 
entirely in binary. Yet, without efficient programming tools, early computers were 
programmed in exactly this manner. Only a pure masochist liked programming in 
machine language, but someone had to do it in order to create the first assembler. 



You would think that it would be much easier to code the same instruction in a 
language that was more suited to the human programmer, while maintaining the 
advantage of machine language execution speed. It would have to be a language 
that allowed the programmer to describe the desired action he/she wants the 
microprocessor to perform. The statements the programmer types at the keyboard 
create what is known as a source file. The statements are later translated to the 
machine code the microprocessor understands. Rather than setting sixteen or 
more switches on a computer’s front panel and loading the values directly into 
memory, an assembler can translate the statements in the source file into the object 
(machine) code required. 

An assembler is itself a program created to automate the many routine, repetitive, 
and error-prone tasks associated with programming a computer directly in 
machine language. The assembler program translates a source file of terse English- 
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like abbreviations known as mnemonics into what is referred to as object code 
and/or machine code. 

Figure 2-2 shows the four primary steps in creating and documenting your pro¬ 
grams: 

1. A program called an editor is used to create a source program. 

2. The source program is translated to an object file by the assembler. The 
assembler optionally creates a listing and a cross-reference file. 

3. The linker produces an executable file capable of being run on the IBM PC. 
Library files may also be used as input to the linker. 

4. The cross-reference utility can then be used to create a cross-reference of all 
symbols appearing in the program and where in the program they appear. 

Because there is a direct relationship between the AL source statement and the 
resultant object code, programs written in AL execute as fast as if the program had 
been entered into the machine in pure machine language. The assembler has 
removed the chore of coding the program in binary. 


1) Editor-►SourceFile (.ASM) 

MOV AH,MY_DATA iAddvaiue 

ADD COUNTER, AH Add tocurrent timer count. 


{Rest of the source program} 


2) Source File-►Assembler ■ " ► Object File (.OBJ) 

(.ASM) MASM.EXE Listing File (.LST) 

Cross Reference File 
(.CREF) 


3) Object File(s)-► Linker-► Executable File (.EXE) 

(OBJ) A 

Library Fiies-^ LINK.EXE 

(.LIB) 


4) Cross Reference File 
(CRF) 


► Cross Reference — - ► Reference 
Utility File 

CREF.EXE (.REF) 


Figure 2-2 Assembly Language Source to Machine Language/Executable Code. 
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Another program—called an editor —is used to create the source program or code. 
CP/M’s™ program ED and MS-DOS’s EDLIN are examples of line oriented editors. 
They allow you to create and edit one line of source code at a time. The line forms 
what is called a statement; MOV AX,16 moves the value of 16 into the accumulator 
of the 8088/86 microprocessor. When a particular line of code has been edited, 
you can begin editing another line. 

A full screen editor is much like a word processing program, because a full screen of 
text (many source lines) is displayed. By using the cursor keys, you can move freely 
around within the source program. In fact, many programmers use word process¬ 
ing software to create their source code files. Combining a full screen editor with 
the advanced editing features of word processing software results in increased 
efficiency by decreasing the amount of time required to create and edit a source 
file. This is a vast improvement over simple-minded and primitive line oriented 
editing. 



One of the many complicated tasks the assembler program can do is to keep track 
of the different memory locations used for data and program storage. Figure 2-3 
illustrates the use of symbols that represent data and memory locations, as well as 
constant numerical values required by the program. Without this ability, you 
would have to keep track of each memory location and data value referenced 
within the program. 

For example, you may want to assign a symbol name to a numeric constant that will 
be used several times in your program. Rather than hard coding the value into the 
instruction, it is often more advantageous to assign the value a name at the 
beginning of your program, and then use the name rather than the value in the 
program. By assigning the label PTR_OUT to the value 03B8H, the program 
becomes easier to read and understand. 

Another example of symbolic usage is in the assignment of a name to a port address. 
Port addresses are used to communicate with input and output (I/O) devices such as 
a printer, video display, or keyboard. Actually, the port addresses belong to the 
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PAGE 55,132 

TITLE Example of Symbol Assignments 

Date: 06/05/84 
By: Gary A. Shade 
Last Revision: 06/05/84 

*^984 by Gary A. Shade, All Rights Reserved. 

This program does a lot of nothing. That Is, it Is only to 
demonstrate symbolic usage in a source program. 

It also demonstrates where each assembler field originates, and the general 
form of an assembly language program. 

Entry Conditions: Save DS then a word of OOOOH on the stack. 

Required by MSDOS. 

Exit Conditions: Registers used within the program are altered. 

Definition of Assembler Fields 


: . Label . 

^ Opcode 

^ Operand ^ 

Comments 

» < > 

EX A STACK 

SEGMENT 

PARA STACK‘STACIC 


DW 125DUP(?) 

; Establish Stack Area 

EX^A_STACK 

ENDS 



EX.DATA SEGMENT PARA‘DATA’ 


COUNTER1 

DB 

OFFH 

; 8 BIT COUNTER 

COUNTER 2 

DW 

OFFFFH 

; 16 BIT COUNTER 

COUNTERS 

DO 

OFFFFFFFFH 

; 32 BIT COUNTER 

EX^DATA ENDS 


;END OF SEGMENT 

EX_CODE_SEG SEGMENT 

PARA‘CODE’ 

; Code Segment begins 

ASSUME CS:EX_CODE,SS:EX_A^STACK,DS:EX_CODE,ES:EX_CODE 

START 

PROC FAR 


; Declare as‘FAR’ 


PUSH 

DS 

; Save Code seg, passed 
; by MSDOS 


XOR 

AX,AX 

; Clear AX 


PUSH 

AX 

; Save on stack. 


MOV 

AX,EX_DATA 

; Set up segment 
; registers 


MOV 

DS,AX 

; Data Segment 


MOV 

ES,AX 

; Extra segment 


MOV 

CX,COUNTER2 

; Get loop delay factor 

DELAY1: 

LOOP 

DELAY1 

; Loop until CX = 0. 


MOV 

CL,COUNTER1 

; Get byte delay count 


XOR 

CH,CH 

; Clear High Order byte 

DELAY2: 

LOOP 

DELAY2 

; Execute LOOP until 
; CX=0 


MOV 

CX,PTR WORD COUNTERS; Delay count 

DELAYS: 

NOP 


; WASTE SOMETIME 


NOP 

LOOP 

DELAYS 

; Execute last loop. 


Figure 2-3 Example of Symbol Assignments 
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hardware, which interfaces the microprocessor to these devices. More than likely 
the port addresses given to these devices will vary from computer to computer. In 
order for the program to be run on another computer using the same micro¬ 
processor, these values and others will have to be redefined. By defining the port 
addresses symbolically, you need only change the line of code which assigns the 
label to a physical port number, rather than changing every occurrence of the port 
address within the program. 

Assume the printer for a given computer is at port address OEOH (the H means the 
number preceding it is given in hexadecimal), or 224 decimal. By writing a 
statement such as: 


PRTOUT EQU 0 E 0 H 


The printer output port (OEOH) is assigned via the EQU directive to the label 
(PRTOUT). There may be a hundred different places in your program where data is 
sent to the printer via port OEOH. If a label were not assigned to the port, a hundred 
lines of code would have to be found, and the port’s value changed if the system’s 
hardware should change. 

One last example of assigning labels within a program can be illustrated by using a 
label to specify a strategic entry point into a portion of the program. As an example, 
consider the following source code: 


START: 


PUSH DS 
XOR AX, AX 

PUSH AX 
CALL INIT 
JMP CLRSCN 


;SAVE CODE SEG PASSED FROM MS DOS 
5MUST SAVE A ZERO OFFSET INTO 
5CODE SEGMENT ON STACK. 

;SAVE NORD ON STACK 
5 INITIALIZE THE SYSTEM 
5CLEAR THE SCREEN 


<MORE PROGRAM STATEMENTS> 


CLRSCN: PUSH DX 


;SAVE REGISTERS 


INIT: 


JMP THERE 5JUMP TO ANOTHER PLACE IN PROGRAM 

CALL DISKINIT 5 INITIALIZE DISK DRIVES 

WHOEVER ;ETC. 


CALL 
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RET {RETURN TO CftLLER 

THEREl MOV ftL, PTROUT ;SET PRINTER OUT PORT 

. . <The rest of the program> 


Nowhere within the program were absolute addresses for the instructions labeled 
START, INIT, THERE, or CLRSCN defined. The assembler calculates the absolute 
memory addresses where each section of code resides when assembling your 
source program. 

Labels are also more easily remembered than are absolute addresses and values, and 
they are more easily changed should the physical values change. The assembler 
remembers the values assigned to the labels used in the program and substitutes 
these values when the assembler translates the source file to object code. 



The IBM Macro Assembler makes two passes through the source file. On the first 
pass, the assembler builds a table of all the symbolic names defined in the source 
file. The assembler does not produce object code on this pass. The second pass 
produces the object code for the source statement based upon the information 
gathered during the initial pass. 

During the first pass, the assembler may not know the exact location of a symbol it 
has encountered but not defined. This is known as a forward reference. It is a little 
like a writer who makes reference to an illustration while writing a book. Usually 
the reference reads something like “Reference Figure 1-XX”. During a second pass 
through the manuscript, after the chapter has been written, the exact figure 
number is inserted. The process is similar to the first and second pass of an 
assembler through a source program. It is only during the second pass that the 
assembler knows the relative addresses and what values to use in place of the 
names and symbols encountered during the first pass. 
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Cross assemblers are used to create object code for a microprocessor other than the 
one used in the computer the code is being developed on. There are several 
companies marketing cross assemblers that run on the IBM PC. By using a cross 
assembler, you can create programs for other microprocessors, such as the 
Motorola 68000 or 6800 series, the Zilog processors (Z-80, Z-8000), and other Intel 
processors, such as the older 8080 and 8085, on your PC. The programs created 
using a cross assembler cannot be executed (run) on the development system, since 
the machine language of each microprocessor is unique to itself. The object code 
must be downloaded, or transmitted, to the target system fojr execution. 

Cross assemblers are of value to anyone who must learn or develop machine code 
for another processor and cannot justify the added expense of another computer 
system to do so. By using cross assemblers, one computer system can be used to 
create programs for many others. 



Previously I mentioned why it is a good idea to develop programs in a modular 
form; smaller chunks of code are easier to debug and understand. Their func¬ 
tionality is much more explicit than one large program. The purpose of the Linker 
is to join these smaller chunks of code together to produce a finished program. 

You can think of a program as being analogous to a chain. A chain is not a chain 
until all the individual links are connected. In a similar manner, a program is not a 
program until all the individual modules have been linked together. 

Program libraries containing dozens of small often-used routines or programs can 
be built and stored on disk. By using the linker and specifying which modules are to 
be linked together to form the completed program, you can create new programs 
without having to write the entire program from scratch. If, as an example, you 
have already written a routine that performs bounds checking on a set of numbers, 
and you need the same routine in a new program, simply include the bounds 
checking module in the linkage. 
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A relocatable object file as shown in Figure 2-4 is produced by the assembler. The 
relocatable expressions are those marked with an R next to the object code. The 
linker also resolves any relocatable expressions, including any values of data, 
constants, or memory addresses that are defined in other modules. When the 
program is loaded and executed, a loader program uses the information supplied 
by the linker, enabling the program to be loaded and executed anywhere in 
memory. 


0039 

C7 

06 0000 R 

0140 

DRAWJT2: MOV 

STARTX,320 

003F 

C7 

060002 R 

OOAA 

MOV 

STOPX,170 

0045 

C7 

06 0004 R 

0032 

MOV 

STARTY,50 

004B 

C7 

060006 R 

0096 

MOV 

STORY,150 

0051 

C6 

06000B R 

07 

MOV 

COLOR,W B 

0056 

E8 

01ACR 


CALL 

DRAW LINE 

0059 

E8 

0242 R 


CALL 

DELAY 

005C 

07 

06 0000 R 

0113 

DRAW_IT3: MOV 

STARTX,275 

0062 

07 

06 0002 R 

0177 

MOV 

STOPX,375 

0068 

07 

06 0004 R 

0064 

MOV 

STARTY.lOO 

006E 

07 

06 0006 R 

0064 

MOV 

STORY, 100 

0074 

C6 

06000B R 

07 

MOV 

COLOR,W B 

0079 

E8 

01ACR 


CALL 

DRAW LINE 

007C 

E8 

0242 R 


CALL 

DELAY 

007F 

E8 

0242 R 


CALL 

DELAY 


Figure 2-4 Example of Relocatable Code 



Syntax 


You’ll notice in Listing 2-1 (see Appendix D) that there are specific fields where you 
enter labels, instructions, operands, and comments to form a source statement. 
The obvious deduction is that a certain syntax must be followed in order for the 
assembly process to occur properly. The format in which the source code must be 
entered is: 


Label Operations~Code Operand(s) Comment. 


Listing 2-1 should be referenced as I discuss how a source program is created. 
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Label Field 


We have seen why labels or symbolic representation within the source program is 
important. The manner in which names are assigned is of equal importance. The 
IBM Macro Assembler allows you to create labels of up to 31 characters in length. 
This allows you to assign meaningful names to constants and program entry points. 
Not all assemblers allow you this flexibility. Labels can consist of any of the 
following characters: 

1. Alphabetic characters: A through Z (lower- or uppercase). 

2. Numeric digits: 0 through 9 

3. Special Characters: $ . _? 

The IBM Macro Assembler manual states, “Labels can start with any character 
except a numeric digit. If a period is used in the label, it must be the first character 
of the label.” Words and names reserved for the 8088 registers and instructions 
should also be avoided, as should words reserved by the assembler (referred to as 
directives) when assigning symbolic labels. Some examples of labels are: 


Valid Label 


Invalid. ->> Comment. 


(Digit 1st character) 

?ftSCII.CONVERSION ?ftSCII.CONVERSION (Illegal use of .) 

LOOP0S0 LOOP (8088 instruction) 

Additionally, a label may contain a colon suffix if the label is used to define an entry 
point into a section of code: 

STftRTs PUSH DS ;SftVE DS ftND AN OFFSET OF ZERO 

XOR AX,AX 
PUSH AX 

There is another use for the colon suffix, and that is to inform the assembler that 
the label is to be assigned a TYPE attribute of NEAR. NEAR attributes can be 
accessed only within a given segment. The absence of a colon informs the 
assembler that the label can be referenced from other segments, and a TYPE 
attribute of FAR should be assigned to the label. 
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Labels should not contain a colon suffix if the label is used with what is known as a 
pseudo-op. This is an assembler directive that instructs the assembler how to 
perform the assembly or what values to use during the assembly. For example: 


PTR^OUT 

EQU 

0E0H 

iASSIGNS 

0E0H TO PRINTER OUT 

PTR^BUFFER 

DW 

100 DUP (?) 

5DEFINES 

STORAGE 

FLPGl 

EQU 

THIS BYTE 

;ASSIGNS 

FLAGl TO TYPE BYTE 


Furthermore, a label should not contain a colon suffix when it is used as an operand 
in an instruction: 

MOV fiL,FLftSl ;MOVES FLfiSl INTO ftL 

MOV PTR WORD FLA61,ftX ;STORE AX IN THE TWO BYTES 

;STftRTING ftT FLAG 1 

A label is defined by entering its name in the first field of the source statement. 
Labels must originate in column one. 


Operations Code 
(bp-Code) Field 


Op-codes are the actual mnemonics that represent the instruction you want the 
microprocessor to execute. Op-codes must be entered in the second field of the 
source statement, separated from the label field by at least one space. To make the 
program more readable, programmers usually use tabs to align the fields of the 
source program. 

An example of an op-code is JMP. JMP is a mnemonic which the assembler trans¬ 
lates to a machine executable instruction. 

When used. Pseudo-ops must also be entered in the op-code field. You’ll notice in 
the previous examples, EQU, DW, and DB are all pseudo-ops that appear in the op¬ 
code field. 
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The operand field tells the assembler what it is we want to move (MOV) or jump 
0MP) to and may require two operands, a source and a destination. An operand 
may be a constant (value), a register, or a label. Some instructions are register 
implicit and do not require any operands at all: 


MOV nx,10H 

MOV ftX,COUNT 

NEG nx 

JMP THPT^PftRT 
CLD 


5 TWO OPERANDS AX^azDESTINATION 
5USING A CONSTANT AS THE SOURCE 
;MOVE THE CONTENTS OF MEMORY 
;LOCATION COUNT TO THE AX REGISTER 
;NEGATE (2*S COMPLEMENT) THE ACCUMULATOR 
5ONE OPERAND, AX = DESTINATION 
;ONE OPERAND, THAT_PART = DESTINATION 
;CLEAR DIRECTION FLAG - IMPLIED OPERAND 
;NOT REQUIRED TO BE EXPLICIT- 


The operand field must be separated from the op-code field by at least one space. 


Comment Field 


A comment must originate in the first column of the label field if the entire line is to 
be a comment, or it must be separated from the preceding field by at least one 
space. Comments must begin with a semicolon (;), as shown in the previous 
examples. All characters entered after the semicolon are ignored by the assembler 
and treated as a comment. Comments make your program more understandable to 
you and others (should they have the fortunate task of maintaining your code after 
you have moved on to greener projects). 

Often, when you are writing programs, it is not practical to completely document 
your code as you write it. However, there should be enough comments to describe 
the code in a precise manner, so that it will be easy for you or someone else to 
understand the program today or a year from now. Once the code has been 
debugged and finalized, go back and more thoroughly document the program by 
adding more comments wherever possible. 
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I have a tendency to occasionally state the obvious in my comments such as: 

JMP START ;Jump to start. 

Nothing infuriates me more than to read a source listing of a program which is 
documented like this. It infuriates me further when I sheepishly recognize the code 
as mine. Why did I jump to START? The reason is not always obvious unless you 
know or remember what function the code at the label START performs. A better 
comment would be: 

JMP START ;Get the next character. 

or whatever the reason may be. Documentation is said to be four times the cost of 
actually writing the program code. In practice I have seen the ratio climb as high as 
10:1 due to the cost involved in writing program documentation months after the 
program was written. 

Even worse is when you encounter a program listing which runs on page after page 
after page, without a single comment. Woe to the poor soul whose job it is to patch 
or understand that program. We’re all guilty of not documenting our programs in a 
textbook manner (Listing 2-1), yet the need to properly document your programs 
cannot be overestimated. 



Let’s jump right into programming in Assembly Language, and I’ll explain the 
design process as we proceed. To enter the source program I’m about to describe, 
you’ll need to use EDLIN or some type of word processing software. Once the 
source file has been created, you’ll assemble, link, and debug the program. 

Don’t worry about not understanding what the source statements mean at this 
point. After I discuss the 8088 instruction set (Chapter 4) and MS-DOS functions in 
Chapter 6, you’ll better understand the source statements found in the program. 
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The First Step; 
Defining the Problem 


Eyery software project consists of several phases. A programmer I once worked 
with commented after a staff meeting that there Were only three major phases to 
any commercial software project. The first phase is when the marketing depart¬ 
ment commits to a customer’s schedule. The second phase is when the software 
department tells the marketing department they’re nuts. And the third phase is 
getting the job done. I’ll discuss only what’s required to get the job done. 

In reality, the first phase of any software project is to define what the program is 
attempting to solve. You can do this by means of an outline, using plain English 
statements to define the problem or by use of a program flow chart or state 
transition diagrams. 

Figure 2-5 depicts the flow charting symbols used to describe program flow 
pictorially. Let’s use these symbols as a design tool to illustrate our program’s logic 
after we state what we want to do. 





Manual Input 


Terminal 



Connector 



Preparation 



Manual Operatbn 



Communications Link 


Figure 2-5 Programmer’s Flow Chart Symbols 
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Objective: Use system calls to read the system configuration of the computer the 
program is being executed on. Then display this information on the user’s console. 

It sounds simple enough. But how do we go about solving the problem? Put down 
some details as to exactly what we want to know about the system configuration. 

I. How many disk drives? 

II. The system’s memory size. 

III. The number of printers available? 

IV. Communications Port? 

V. Graphics board? 

VI. Game Port Attached? 

Create a flow chart of the program and describe each process as it relates to the 
diagram. Figure 2-6 is the flow diagram I designed. You may have come up with a 
different flow chart, which is perfectly legal. It’s the results that count. 


The Second Step: 
Writing the Source Code 


This step is fairly straightforward. If you have created a good flow chart in the 
previous step, all that has to be done is to choose the proper 8088/86 instructions 
to accomplish the task. Listing 2-1 is the source code I used to solve the problem. 
You may, after becoming familiar with the instruction set of the 8088 and MS-DOS, 
have chosen a similar algorithm (solution) and similar instructions. You might also 
have chosen a totally different algorithm, or set of instructions, to perform the 
same task. 

You’ll enter the source code using EDLIN (see youtlBMDOS Operations Manual) 
or another editor (the source code is also on the disk which accompanies this 
book). Use the filename CONFIGSY.ASM when you open the source file. Once the 
code has been entered, save the file to disk. 
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INITI: 

Set up Registers 


GET_MEM: 

INT 12H 

SAVE MEMORY SIZE 

GET_SYS 

INT11H 

SAVE HARDWARE TYPES 
CLEAR THE SCREEN 
MOV 24 to CX 


DO CR/LF Combination 


LOOP 
IS CX = 0 


MEM_SHOW: 

Display Memory Size 


DCONFIG: 
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Figure 2-6B 
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Once the source code has been entered and the file has been saved to disk, you’ll 
invoke the assembler to translate the source program to machine language. From 
the MS-DOS prompt, type (Note: <CR> means press the return key): 


MS DOS PROMPT You Type 

A> masm <CR> 

Source Filename C.ASWl: CONFIGSY.ASM <CR> 

Object Filename C.0BJ3: CONFIGSY.OBJ <CR> 

Source Listing CNUL.LST3: CONFIGSY.LST <CR> 
Cross reference CNUL.CRF3: CONFIGSY.CRF <CR> 


If there is an error, use the TYPE command from DOS to list your CONFIGSY.LST 
file. This file will contain any error messages and the line where they occurred. 
Compare the listing to the one shown in Listing 2-1, correct the error, and repeat 
the assembly process until the file assembles properly. 








38 8088!IBM PC Assembly Language Programming 


The Fourth Step: 
Using the Linker 


Once the source file has been assembled, use the linker to produce an executable 
program file. From DOS type: 


MS DOS 
A> 

Object Modules C.OBJl 
Run File Cft:C0NFI6SY.EXEl 
List File CNUL.MAPI 
Libraries C.LIBl 


You Type 
Link 

CONFIGSY.OBJ <CR> 
<CR> 

CONFIGSY.MAP <CR> 
<CR> 


You have now created a file on disk, CONFIGSY.EXE, which can be used to find 
the configuration of your system. 


The Fifth Step: 
Create a Cross Reference File 


MS DOS You Type 

A> CREF.EXE 

Cross Reference C.CRFl CONFIGSY.CRF 

Listing Cross Reference.REF3 CONFIGSY.REF 



When you invoked the IBM Macro Assembler, you used your source file CON¬ 
FIGSY. ASM as the input file to the assembler. You then specified the names of three 
files that were created by the assembler. CONFIGSY.OBJ is the object code output 
file. CONFIGSY.LST is the program listing that contains, on a line-by-line basis, the 
object code generated from translating each line of the source (.ASM) file. 
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The Object File 


The object file, CONFIGSY.OBJ, contains information used by the linker to pro¬ 
duce the executable file, CONFIGSY.EXE. The object file cannot be run on the 
computer; whereas, the executable file can be run by typing CONFIGSY.EXE from 
the MS-DOS command prompt. The linker creates an executable file by appending 
the necessary information MS-DOS requires to load and execute the program. 


The Listing File 


Listing 2-2 in Appendix D is the printout of the listing file, CONFIGSY.LST. The 
format of the listing consists of the following fields: line numbers, relative segment 
offsets, object code, and source fields. 

Notice that the listing produced by the assembler contains line numbers in the left¬ 
most field. Line numbers and comments contained in the source file are not 
translated by the assembler; they produce no object code. 

Assembler directives, such as the PAGE and TITLE directives, also produce no 
object code. Directives control and inform the assembler how to carry out the 
assembly process. For example, the PAGE directive commands the assembler to 
assemble the program formatted for a certain number of lines per page (56, in this 
example) containing a certain number of characters per line (132, in this example). 

I’ve used many messages and defined them in the data segment. The object code 
produced by these source statements happens to produce ASCII code in the object 
file. Just as the programmer makes the decision to use a specific bit pattern to 
represent a signed or unsigned numeric value in binary, so is a decision made as to 
whether or not the bits contained in a data byte are to be interpreted as ASCII. 

Look now at the code produced by MEM_MESS. 4DH is the ASCII representation of 
the letter M. 65H is the ASCII code for a lowercase e. Each letter of the message is 
translated to its ASCII equivalent. 

The relative offset of the object code produced by each source statement (relative 
to the start of the segment) is contained in the second field. MEM_MESS begins at 
the offset OAH from the start of the data segment. That is to say, the ASCII code for 
the letter M of the message block is stored at the tenth byte from the start of the 
segment. 
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Cross Reference File 


The cross-reference file generates a detailed listing of all the symbolic names used 
in the program. Next to the label’s name is the line number where the label 
originates, and every line number where the symbol name is referenced. For 
example, the line symbol MEM_MESS originates at line 25 and is referenced on line 
128. To verify this, look at Listing 2-2 to confirm that the cross-reference listing is 
indeed accurate. 

To generate the cross-reference listing, you must specify a cross-reference file 
name when running the assembler. You did this by specifying the file name 
CONFIGSY.CRF at the appropriate prompt. Next, you ran the cross-reference 
utility CREF.EXE, which used the CONFIGSY.CRF file as the input file and, in turn, 
produced a file named CONFIGSY.REF. 

This information is extremely useful when you have to debug a program. You’ll 
come to appreciate the many different types of listings the assembler and linker 
create when you have to debug your first program. It’s a little like trying to read 
and understand a boiok in the dark. Debugging a program without the aid of a listing 
is just as impossible. 

Chapter 3 describes the 8088’s architecture. In subsequent chapters I’ll use pro¬ 
grams similar to this one to illustrate advanced features of the assembler. 



1. You must obtain a PH.D. in applied physics before you can program in 
assembly language (True or False). 

2. BASIC executes faster than all known language types (True or False). 

3. To enter a source file, you must use an editor such as MASM (True or False). 

4. Real programmers enter all their programs in machine language (True or 
False). 

5. If you answered false to question four, why don’t they? 
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6. The primary advantage assemblers have over writing programs directly in 

machine language is that you can use_rather than _ 

addresses. 

7. _programming allows programs to be developed in smaller 

chunks, which makes the program easier to_,_and 


8. Each field in a source program must be separated by at least one 

9. A well-documented program contains many_. 

10. Why are comments important? 




With the introductory chapters behind us, it’s time to focus on the 8088 and the 
IBM PC. In this chapter I will examine the 8088’s architecture and the architecture 
of the IBM PC. The term architecture, refers to what’s inside the 8088 and the PC, 
from the programmer’s point of view. In terms of the 8088, it’s the register set, 
instruction set (discussed in Chapter 4), and the memory addressing modes avail¬ 
able. 



Computer architecture is composed of the three primary sections. Figure 3-1 
illustrates the three main sections of a computer system: memory, input/output 
(I/O), and the central processing unit (CPU). The CPU contains an arithmetic logic 
unit (ALU) that carries out arithmetic operations for the CPU and storage locations 
called registers. The registers are used to move data to and from the CPU to 
memory and the I/O sections. 
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Figure 3-1 Sections of a Micro Computer 


The control section in a microprocessor-based system is the brain of the system; it 
is the microprocessor itself, the CPU. Its function is to control data transfers to and 
from the microprocessor and the other sections of the computer. Most CPUs will 
sequentially fetch, decode, and execute the machine instructions as they come 
from memory. 

The 8088 has a slightly different architecture, which speeds up this fetch/- 
decode/execute cycle. This is shown in Figure 3-2. 

As can be seen, the instruction fetch and execution cycles of the 8088 are overlap¬ 
ped, allowing the 8088 to substantially increase the microprocessor’s throughput. 
The 8088 implements two independent units which are internal to the chip. These 
are the BIU (Bus Interface Unit) and the EU (Execution Unit). The BIU of the 8088 
fetches and reads and writes data via the system’s bus. It fetches instructions from 
memory and places them in a 4-byte queue (6 bytes for the 8086). (Source Intel). 

The EU removes the data and instructions placed in the queue by the BIU and 
executes them. This technique, which is referred to as pipelining, allows the fetch 
and execution cycles to overlap. While the EU is executing instruction, the BIU is 
fetching another from memory. Whenever the program branches to another part 
of the program, the queue is emptied and filled with data and instructions begin¬ 
ning at the new execution address. 

The CPU also contains some general purpose and dedicated storage locations 
internally. These storage locations are referred to as registers. Usually a CPU will 
have at its disposal one or more accumulators that are used for arithmetic opera¬ 
tions and one or more index registers that are used to hold addresses or pointers 
into memory. Additionally, there will be other registers designed with more 
specific uses in mind. 
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Execution Unit 
(EU) 

Bus interface Unit 
(BUi) 

General Registers 

AX 

BX 

CX 

DX 

SP 

Dl 

SI 

Segment Registers 

CS 

DS 

ES 

SS 

Instruction Pointer 

IP 

ALU 

INSTRUCTION QUEUE 


4 Bytes 

STATUS FLAGS 




Pipelining vs. Sequential Execution 


Elapsed Time:- 



-► 



2nd 

Generation Microprocessor 


CPU: 

Execute 

Write 

Fetch Execute Fetch 

Read Execute 

BUS: 


Busy 

Busy Busy 

Busy 



8088/8086 Microprocessor 


CPU: 

Execute 


Execute 

Execute 

BIU: 

Fetch 

Fetch 

Write Fetch Read 

Fetch 

BUS: 

Busy 

Busy 

Busy Busy Busy 

Busy 


Figure 3-2 8088 Architecture 


Specialized Registers 


The CPU’s instruction pointer always points to the next instruction to be executed. 
The stack pointer points to the next available storage location in a RAM area known 
as the stack. The CPU has a register to record the status of the instructions the CPU 
executes. This register is referred to as the status, or flag, register. 
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Another important part of the CPU is the Arithmetic Logic Unit (ALU). Its purpose 
is to perform arithmetic calculations and set the flags in the status register accord¬ 
ingly. If one number is subtracted from another number and the result is zero, the 
ALU is responsible for setting the zero flag (ZF) in the status register. In the 8088, 
the ALU is a full 16 bits wide and can be used in 8-or l6-bit arithmetic operations. 


Memory 


The memory section stores the program instructions in the binary format discussed 
in Chapter 1. The memory section also holds data required by the program. The 
amount of binary data each memory location in the PC is capable of storing is one 
byte. An analogy can be drawn between the way these storage locations are 
accessed and the way a mailman delivers mail to someone’s house. A unique 
address is assigned to each home on a given street. The same is true for each 
available storage location in memory. 

The CPU is the microprocessor’s mailman. It generates the desired address by 
placing the proper electrical signals at the physical pins of the processor chip 
designated for this purpose. The memory section responds by allowing the CPU to 
read data (accept mail) from the specified memory location or by allowing the CPU 
to write data (deliver the mail) into the location being accessed. Addresses start at 
memory location zero and continue to the maximum address the microprocessor 
can generate. In the case of the 8088, this upper limit is FFFFFH, which is over one 
million memory locations (1,048,576, to be exact). This corresponds to the total 
possible binary combinations the 8088 can generate via its 20 address lines (2 
raised to the 20th power = 1,048,576). 

RAM, an acronym for Random Access Memory, is a type of memory that can be read 
from and written to. The programs you write for the IBM PC are read from disk and 
placed in RAM for execution. Unfortunately, whenever the computer’s power is 
turned off, the information stored in RAM is lost. 

In fact, the RAM in the IBM PC (and most computers) needs to be refreshed 
periodically while the system is on. This type of memory is known as Dynamic 
Random Access Memory, or DRAM. Each bit of memory can be thought of as small 
capacitor which stores a charge. Without periodically refreshing each bit cell, the 
cell’s charge will slowly discharge. Memory refresh is nothing more than the 
system reading the contents of a given RAM location and writing that value back to 
the same location, thereby replenishing the charge for that bit. Refresh is trans¬ 
parent to the user and is something the Assembly Language programmer normally 
is not concerned with. 

ROM (Read Only Memory) can only be read from, not written to. The data 
contained within the ROM is therefore said to be unalterable or nonvolatile. ROM is 
used in the IBM PC to store the program that monitors the system’s resources when 
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the computer is turned on. The program checks to see what I/O devices are 
attached to the system, how much RAM is installed in the system, and if the 
resources are functional. The ROM also contains the BASIC interpreter and indi¬ 
vidual routines that form what is known as the computer’s Basic Input/Output 
System or BIOS. These routines allow a convenient method for the applications 
programmer to access the system’s resources: printers, disks, keyboard, video, etc. 

A small program called a bootstrap loader is also contained in the ROM. Its 
function is to read in the first sector of information from the diskette containing 
MS-DOS. Once this information is read from disk into the system’s memory, the 
ROM passes control to the program read from disk, which loads the rest of DOS 
into memory. 

Segmentation ' 

The 8088 views its IM byte of memory as being comprised of segments that can be 
up to 64K bytes in length. There is a memory segment for your code, data, and 
stack. Each segment is associated with specific registers, known as code segment 
registers, and pointers that contain offsets into the segment. By using the segment 
and offset registers, data may be accessed anywhere within the segment. I’ll discuss 
the 8088 s segment registers and memory segmentation in detail later in this 
chapter. 


How Data Is 
Stored in Memory 

The 8088 microprocessor stores l6-bit values in memory in what appears to be 
reverse order. The low order byte of a l6-bit value is stored in the lower memory 
location, with the high order byte being stored in the next higher memory loca¬ 
tion. In a moment I’ll discuss the various registers within the 8088. When we 
visualize how data is stored in the registers and contrast this view with how data is 
stored in memory, it appears as if it has been saved in reverse. Figure 3-3 demon¬ 
strates how the data value 0F07H is stored in the 8088 register AX and how the 
value would be stored in memory. 

As can be seen from Figure 3-3, values stored in memory appear to be stored in 
reverse when compared to the same value as it is stored in a register. Remember, 
AX is comprised of two 8-bit registers, AH and AL. AH is the high order 8-bit 
register, and AL is the low order 8-bit register. Therefore, when the entire l6-bit 
word is stored in memory, AL is stored at the lower memory location, and AH is 
stored in the higher memory location. When data is read from memory, the low 
order memory byte is placed in AL, and the high order byte is placed into AH. 
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High Low 
Byte Byte 
AH AL 


Value in AX = 


OF 


07 


Value In Menrory COOOO = 07H 
Value In Memory C0001 = OFH 


0F07H 


Memory 


COOOO C0001 
Low High 
Byte Byte 


07 


OF 


Figure 3-3 Data Storage in Registers and Memory 


Procedures and Stacks 


Procedures, or subroutines, are specialized and often-used mini-programs. The 
functions they perform may be required in several places in a large program. Rather 
than writing the same instructions over and oyer again, the routine is made into a 
procedure that is called as needed by the main program. This helps to conserve 
memory and makes the program easier to maintain should the procedure ever need 
to be rewritten. 

RAM is also used for temporary storage of data in what is referred to as the STACK. 
Stacks are areas in RAM that are used by the microprocessor to save certain registers 
during special operations. 

In much the same manner as memos are deposited and removed from an IN basket 
on an office desk, so are addresses and data pushed and popped from the stack. The 
last piece of paper put into the IN basket is the first one taken from basket. In the 
8088, a register known as the stack pointer (SP) points to the top of the stack (TOS). 
When values are pushed on the stack, the stack pointer is decremented by 2, and 
the word value is written to the memory pointed to by the stack pointer. Each push 
stores 2 bytes (a word) of information on the stack. Figure 3-4 illustrates how the 
stack grows downward in memory each time data is pushed onto it. 
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Figure 3-4 Stack Operation 


When a procedure is called from the main program, the processor saves the address 
of the instruction immediately following the CALL instruction. This pointer is 
saved by the 8088 by pushing it onto the stack. The address of the procedure that 
was called now becomes the new instruction pointer. 

The last instruction executed in the procedure is the return instruction, RET. When 
the RET instruction is encountered, the value previously pushed onto the stack is 
retrieved (popped off the stack), replacing the contents of the instruction pointer 
(IP). Control is returned to the instruction immediately following the instruction 
that called the procedure. 

When a program calls a procedure which resides in another segment, not only is 
the value of IP saved on the stack, but so are the contents of the segment register CS 
(code segment). CS is then loaded with the segment address of the procedure, and 
IP is loaded with the offset of the first instruction in the called procedure. On 
return, the previously saved register values are popped from the stack, allowing 
program execution to resume with the instruction immediately following the call 
instruction. 
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When data are popped from the stack, the word value stored at the top of the stack 
is written to the register designated in the POP instruction, and the stack pointer is 
incremented by 2 to point to the new top of stack. 

As Figure 3-4 shows, the CALL instruction decrements the stack pointer by 2 and 
places the contents of the instruction pointer in the location pointed to by the 
pointer. The PUSH instruction also decrements the stack pointer by 2 and places 
the contents of the AX register (in our example) onto the stack. POP and RET each 
copy a word value from the top of the stack and increment the stack by 2. POP 
retrieves a value and places it into the register specified. RET always fetches either a 
word or double word from the stack and places it into either IP (intrasegment RET) 
or into CS and IP when an intersegment return is required. Notice how the stack 
grows downward in memory each time a value is pushed onto the stack and shrinks 
upward with each POP. 

The stack is also a convenient place for the programmer to temporarily store data. 
As an example, perhaps you need to use the AX register for an operation, but the 
value currently in the AX register is of importance and cannot be lost. You need a 
quick and convenient place to store the current contents of AX. A commonly used 
technique is to save the register’s contents on the stack, perform the required 
operation and restore the register with its original contents by popping its previous 
value from the stack. 

I’ll discuss interrupts in a moment, but for now, keep in mind that the CPU, on 
receipt of an interrupt, saves not only the instruction pointer on the stack, but the 
status flags and the code segment (CS) register as well. When the interrupt service 
routine is finished, an interrupt return (IRET) instruction is executed which 
restores the register’s CS, IP, and the status register with the values previously 
stored on the stack. 


Input/Output Section 


The I/O section of a computer consists of the physical interface between the 
microprocessor and some type of peripheral device, such as a keyboard, printer, 
video display unit, or a disk drive. 

In other applications, the microprocessor may be required to communicate with 
more exotic devices, such as an analog-to-digital converter, which is designed to 
translate an analog voltage level to a binary word the computer understands. The 
A/D may be attached to a sensor or a transducer and incorporated in machines used 
in a factory environment. 

Whether the I/O device is a switch attached to the IBM or a transducer’s output 
which is attached to an A/D expansion card in the IBM, some type of interface 
between them and the microprocessor is required. Without an I/O section, humans 
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would never be able to communicate with the computer, nor would the computer 
be able to communicate with real world events. 



The Control Bus 


The CPU issues control signals over what is known as the control bus. These signals 
control data transfers between the CPU, memory, and the I/O section of the 
computer. The 8088 is capable of operating in two modes, minimum and max¬ 
imum. The control signals generated by the 8088 are different in each of the two 
modes. 

The signals generated and received by the 8088 form three main bus architectures 
within the system (Figure 3-5B). The address bus is composed of the signal lines 
AD0-AD7 and A8-A20. AD0-AD7 are time multiplexed, which means that at one 
particular instant they are used for transmitting an address to the memory or I/O 
sections, and at some other instant in time they are used for transmitting and 
receiving data. Therefore, AD0-AD7 comprise the data bus of the computer 
system. The control bus is comprised of all the other signals (with the exception of 
the VCC and GND signals, which are part of the power bus and supplies the 8088 
with the necessary operating voltages.) 


Minimum Mode 

The control signals generated by the 8088 microprocessor in minimum mode are 
M*/IO, RD*, and WR* (* means that the signal must be a binary 0 or a logic 0 to be 
considered true). 

M*/IO tells the system whether the operation is a memory transfer or one involving 
Input/Output (I/O) devices. If the line is low, a memory access is assumed. If the 
line is high (logic 1), an I/O operation is dictated. The RD * signal allows the CPU to 
read data from memory, and the WR* signal, to write data into memory. The CPU 
generates all the necessary bus control commands. 


Maximum Mode . 

In maximum mode, the signals which were used in the minimum mode are 
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redefined to support multiprocessor (more than one microprocessor) configura¬ 
tions. Fortunately for you, the configuration of the 8088 as used in the IBM PC is 
the maximum mode. This allows you to add co-processors like the Intel 8087 
numeric processor, which speeds up mathematical calculations. 


The Address Bus 


In conjunction with the control bus, the 8088 issues the appropriate address for the 
operation specified. The 8088 is capable of addressing over IM (million) bytes of 
memory via address lines A0-A19. The address lines are unidirectional; they are 
outputs from the 8088 and serve as inputs to the memory and I/O sections of the 
system. 

The 8088 can generate up to 65,536 I/O port addresses by using the low order 
(A0-A16) address lines of the address bus. The 8088 is also capable of byte or word 
I/O, just as it is capable of performing byte or word memory transfers. 


The Data Bus 


The 8-bit data bus of the 8088 transfers data, 8 bits at a time to and from memory 
and the CPU. The data lines of the 8088 are shared with the address lines A0-A7. 
Signals SO, SI, and S2 are used to inform the 8288 bus controller of the type of bus 
cycle currently being executed (Figure 3-6). 

When used in a maximum configuration, the 8088 supplies the 8288 bus controller 
with three signals, S0-S2. These signals are used to inform the 8288 of the type of 
bus cycle currently being executed. The 8288 generates the appropriate signals to 
demultiplex and latch the contents of the AD0-AD7 and execute the desired 
function (memory or I/O read or write, etc.). (Source Intel, used with permission). 

The 8288 chip decodes the status lines and generates the necessary signals to 
control other support chips known as latches. Since the address lines A0-A7 may 
contain either data or address information, these lines are said to be multiplexed. 
The 8288 bus controller generates a signal DEN, which is used to enable data 
latches when the lines contain data. A signal ALE is used to enable address latches 
when the information on A0-A7 is to be interpreted as part of an address. Figure 
3-7 depicts the possible states of the status lines S0-S2 and their interpretations. 

A related processor manufactured by Intel is the 8086. The major difference 
between the 8088, which is the microprocessor in the IBM PC, and the 8086 is that 
the 8088 must always transfer data 8 bits at a time, while the 8086 is capable of 
transferring data 8 or 16 bits at a time. There are other minor differences between 
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Figure 3-6 8088 and 8288 Bus Controller (Maximum Mode) 
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Figure 3-7 Status Line States 


the 8088 and the 8086, but they can be considered insignihcant from the program¬ 
mer’s point of view. Both microprocessors execute the same instruction set. 

The primary difference between a microcomputer and microprocessor is that a 
microcomputer contains the three primary sections: CPU, memory, and I/O. A 
microcomputer can consist of a microprocessor and a separate memory and I/O 


IHHU 








8088 Architecture 55 


section. This type of system architecture can be found in the PC. However, there 
are single chip microcomputers available as well. The Intel 8748, 8031, 8051, and 
8096 are all microprocessors that incorporate the three sections of a microcom¬ 
puter on a single chip. Therefore, they are referred to as a microcomputer chip and 
not as a microprocessor chip. 



Figure 3-8 shows the memory map of the IBM PC. Notice that not all of memory is 
available to you. Some of the memory is dedicated to storing values that are 
required by the system to function properly. Many of these values serve as address 
pointers to service routines which the 8088 vectors to under certain conditions. 
Specifically, the vectors are used by the 8088 to find interrupt service routines, 
routines that are executed any time the 8088 is interrupted. 



Internal Architecture 


The 8088 contains an internal register architecture consisting of fourteen l6-bit 
registers. There are three primary classifications to the register set: data and 
pointer registers, segment registers, and control registers. The data registers AX, 
BX, CX, and DX can be used in 8-bit or l6-bit operations. If the X designation is 
used, as in AX, the reference implies 16 bits. However, you can also reference either 
the high order or low order byte of each data register by using the designations of H 
or L, as in AH or AL. 
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1) Data registers: AX, BX, CX, DX, Si, Di, BP, SP: 

Word length in bits 


b15.bO 

[b0-b7 = Low order half of register) 


(b8-b15 = High order half of register) 

AX (Accumulator) 

{AH and AL used in 8-bit operations) 

BX(Base) 

(BHandBL" " " " ) 

CX (Count) 

(CHandCL" " " " ) 

DX(Data) 

{DHandDL" " ' " ) 

Index registers: 

DI (Destination index) 


SI (Source index) 

Pointer registers: 

SP (Stack pointer) 


BP (Base pointer) 

II) Code segment registers: DS, BS, CS, SS: 


DS (Data segment) 


ES (Extra segment) 


CS (Code segment) 


SS (Stack segment) 

III) Control registers: IP, SR: 


IP (Instruction pointer) 


SR (Status register) 


Segmentation 


The 8088 has been shown to contain 20 physical address lines capable of address¬ 
ing over IM byte of memory. You’ll notice, however, that the largest register 
within the 8088 holds only 16 bits (16 bits can generate a maximum of 64K 
addresses). How is it then, that we can access over 1 million bytes with the 8088? 
The answer is not at all obvious. 

The processor calculates where in the one million bytes of memory each logical 
64 k segment resides by using a pointer in conjunction with a segment register. The 
se^ent registers, CS, DS, ES, and SS point to the beginning of specific segments. 
Each of the segment registers are associated with other registers that contain an 
offset into the 64K segment to facilitate the addressing of information within the 
segment. 
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Figure 3-8 IBM PC Memory Map 
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For example, the CS register holds the start address of the current 64K code 
segment. The instruction pointer, IP, contains an offset into the code segment, 
which points to the next instruction to be executed. The 8088 calculates the 
effective address by shifting the contents of the segment register left 4 bit positions 
and filling the LSBs with zeros. This in effect appends 4 bits of zeros to the value 
contained in the segment register. The segment offset contained in IP is added to 
the 20-bit value obtained by shifting the code segment register 4 bit positions. The 
result is the effective, or actual, address required by the operation. 

Some examples of how a physical address is calculated follow: 


Assume 
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» 001AH 



B7AS0 

001A 
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<___ 
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<- 
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7DDF9 
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Figure 3-9 illustrates the concept of segmented memory. Notice which pointer 
registers are associated with each segment register. In the 8088, instructions are 
always accessed with CS plus the offset of IP. Similarly, the stack is always accessed 
by using the SS and an offset contained in SP or BP. The data segment can be 
accessed by using either DS or ES and the offset specified in SI, DI, or BX. ES points 
to the extra segment and is associated with DI, while DS points to the data segment 
and is associated with SI. The extra segment and data segment are both used for 
data storage. 

Segments can be organized in memory so that they are adjacent to each other. They 
may also be arranged in such a manner that they overlap, either partially or fully. 
When segments overlap, different programs, or tasks, can share data. When seg¬ 
ments are arranged in an adjacent manner, programs can be written that allow data 
to be operated on locally by one task and not be shared by others. Segments must 
start on a l6-byte boundary in memory and must NOT be larger than 65,536 bytes. 
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Table 3-1 

Summary of Register Operations 


Register 

Operations 

AX 

Word Multiply/Divide 

Word I/O 

AL 

Byte Multiply/Divide/10 
Translate, Decimal, Arithmetic 

AH 

Byte Multiply/Divide 

BX 

Translate 

CX 

String Operations 

CL 

Variable Shift and Rotate 

DX 

Word Multiply/Divide 

Indirect Input/Output 

SP 

Stack Operations 

SI 

String Operations 

DI 

String Operations 


(Source: Intel, used with written permission) 


segments other than the current stack segment by specifying a segment override 
prefix within the instruction. SI and DI are offsets into the current data segments. 
SI is associated with the current data segment (DS), while DI is associated with the 
current extra segment (ES). 


Status Flags 


The flag register provides you with the information necessary to make decisions 
based on a previously executed instruction. Assume for a moment that you want to 
execute one of two possible portions of code. The decision to execute one or the 
other is based on the value stored in the accumulator, AX. If the value is zero, you 
want to execute routine number 1. If the value is nonzero, you want to execute 
routine number 2. 

If the result is zero, the ZF (Zero Flag) is set. Your program can then use the 8088 
instruction JZ (Jump if Zero), to transfer control to routine number 1. 

Carry Flag — (CF) — (bO) — 

The carry flag signifies that a carry out of the most significant bit has occurred from 
a previous addition of two numbers. For 8-bit addition, the carry is set when the 
addition causes a carry to be generated from bit 7. Similarly, the carry is set during 
l6-bit addition when there is a carry out of bit 15. Subtraction causing a borrow into 
the MSB also causes CF to be set. This can occur when two values are subtracted or 
compared, and the destination operand is smaller than the source operand. 
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Figure 3-10 Status Register Flags 


The carry can also be used to isolate a specific bit by rotating or shifting the bit into 
the carry flag. The program example at the end of Chapter 1 used this technique to 
determine if certain resources were available to the system. Bit 0 of the word used 
by MS-DOS to describe the system’s equipment configuration is used to signify 
whether the system contains disk drives. By rotating bO into the carry, a test can be 
made to determine whether the bit is set or reset. 

Bit manipulations are not one of the strengths of the 8088 microprocessor, yet 
individual bits can be tested in the manner just described. 

Parity — (Pf)—(b2)- 

The parity flag is set if, after an operation, the total number of 1 bits contained in the 
result is even. If the total number of I’s is an odd number, the parity flag is reset. 

Auxiliary Carry 

-(AF)-(1>4)- 

The AF flag is set whenever a carry into (on subtraction) or out of (addition) bit 3 
occurs. This can occur when adding, subtracting, or comparing numbers repre¬ 
sented in packed binary coded decimal format. The 8088 sets this flag for any 
operation that causes a carry out of bit 3. 

Zero Flag — (ZF) — (b6) - 

The zero flag is set if the result of an operation yields a zero result; otherwise, ZF is 
reset (0). 
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SignFk^—(SF) —(b7)-- 

The sign flag is set (logic 1) if the most significant bit of the result is set. If you recall 
from Chapter 1, signed numbers that are represented in binary notation use the 
MSB of a byte or a word as a sign bit. The bit is zero if the number is positive and 1 if 
the number is negative. SF is used to indicate whether the result is positive or 
negative and mirrors the MSB of the result. 

Overflow Flag — 

(OF) - (Ml)- 

The overflow flag is set whenever two signed numbers of the same sign (i.e., hoth 
positive or hoth negative) produce a result larger than the destination operand (the 
sign has changed). For example, when FFH is added to 80H, a result of 7FH is 
returned. Bit 7 in both operands is set, as both operands are negative values, but bit 
7 in the result is a binary zero. The result of the addition causes the sign bit to 
change. This operation would cause an arithmetic overflow (OF = 1) and generate a 
carry (CF = 1). 

Multiplication Indicators 
(CF and OF) .. - 

The carry and overflow flags also provide information about a previous word or 
byte multiplication. Multiplication of two 8-bit operands returns the high order 
half of the l6-bit result in AH and the low order half of the result in AL. If the 
operands are 16 bits in length, DX will contain the high order half of the 32-bit 
result and AX will contain the low order half. In either case, CF and OF are both set 
if the high order half of the result is a nonzero value for unsigned multiplication. 
When signed numbers are multiplied, CF and OF are both set if the high order half 
of the result is not a sign extension of the result; otherwise, CF and OF are both 
cleared. 

TrapFlag —(TF) —(bS)- 

When the trap flag is set, the 8088 enters a single step mode of operation. This 
mode is quite useful for debugging a program. You can set or reset this flag. When 
this bit is set, the 8088 executes a type 1 interrupt after executing the current 
instruction. The debugging program’s address must be specified in the type 1 
interrupt vector (see Figure 3-8). 

Interrupt Flag — 

(IF)-(b9)- 

The interrupt flag is used to enable or disable external interrupts. You can set or 
reset IF. If IF is set to 1, then interrupts are enabled. When IF is zero, interrupts are 
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disabled. One interrupt which cannot be disabled in this manner is the NMI or 
nonmaskable interrupt. The NMI cannot be masked or disabled by clearing the IF 
bit in the flag register the way other external interrupts can. 

Direction Flag — 

(DF) — (blO)- 

The direction flag is used during string operations and can be set by the program¬ 
mer. With the 8088 it is possible to point one of the index registers (SI) to the 
source string and the other index register (DI) to the destination string. Then by 
using one of the string instructions which I’ll discuss in Chapter 4, you can 
compare or move one string to the other. The state of the direction flag automati¬ 
cally increments or decrements the index registers, SI and DI, during a string 
operation. When DF is set to a binary 1, the index registers are incremented by 1. If 
DF is binary zero, then the index registers are decremented each time the string 
instruction is repeated. 


Interrupts 


Have you ever been working at the office when the telephone rings? While talking 
on the telephone, someone walks up to your desk. You put the party on the 
telephone on hold and find out what the person who interrupted the conversation 
wants. Then while taking care of the interruption, your boss sticks his head in the 
door and tells you to report to his office immediately. Let’s examine this scenario 
in more detail. 

Whether you know it or not, you have responded to multiple interrupt sources. 
You put the party on the telephone on hold and serviced the interruption of the 
person who walked up to your desk. While servicing this interrupt, let’s also 
imagine someone brings you the mail. This interrupt is of a lower priority than the 
one you are currently servicing, so you ignore it for the time being. When your boss 
tells you to report to his office, you cannot ignore the interruption, and you 
immediately service the boss’s request for attention. Your boss has the highest 
priority in this scenario. 

You finish taking care of whatever it was that your boss wanted, and you return to 
your coworker waiting patiently at your desk. “Let’s see, where were we? . . . Oh 
yes, I remember ....’’ You retrieve the conversation’s status at the time of the 
boss’s interruption and continue from the point where the conversation left off. 
You now finish your conversation with your coworker and return to your tele¬ 
phone conversation, “Let’s see, where was I . . . Oh yes, I remember ....’’ You 
continue your telephone conversation from the point in the conversation where 
you left off. You finish the conversation, say your good-byes, and hang up. Now 
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you remember the mail has arrived. You look through the mail for anything of 
importance and then return to your normal routine, that which you were doing 
before all these interruptions occurred. 

Microprocessor interrupts are not much different from what has just been 
described. The microprocessor can be interrupted from its normal programming 
by external events, just as if the doorbell or telephone were to interrupt you from 
your normal chores. Interrupts are said to be asynchronous; they can occur at any 
time without being synchronized to other system components, such as the sys¬ 
tem’s clock. Characters typed from the keyboard are good examples of 
asynchronous interrupt, as the characters are not precisely timed. They occur at 
irregular intervals. When the 8088 receives a keyboard interrupt due to a key being 
pressed or released, the processor goes to the appropriate interrupt routine to 
determine what key was pressed. 

Just like the human analogy, the 8088 services interrupts in the following manner: 

1. The 8088 first finishes the current instruction being executed, 

2. fetches the interrupt vector number from the 8259A programmable inter¬ 
rupt controller (PIC), 

3. saves the status flag register, 

4. clears the interrupt flag (IF) and the trap flag (TF), 

5. and saves its place in the program by pushing the code segment register (CS) 
and then the offset register (IP) on the stack. 

When the 8088 has finished executing the interrupt routine, it restores the status, 
segment, and offset registers, which were saved at the time of the interrupt, and 
returns to the main program where normal program execution resumes. 


Maskable and Nonmaskable 
Interrupts (NMI) . . . . 

Certain interrupts can be masked (ignored). When IF is cleared in the flag register, 
the 8088 ignores external interrupt requests. When IF is set, the 8088 responds to 
the interrupts. Nonmaskable interrupts cannot be masked. They always grab the 
8088’s attention. Typically, the NMI interrupt is used to signal a low voltage 
condition or power feilure. 

You can think of maskable interrupts as those which can be screened. You can have 
a receptionist or the company’s telephone operator take messages for you while 
you are in a meeting. The messages will be there after you finish your meeting. 

Nonmaskable interrupts are those that must be serviced no matter what. Even 
though you have told the receptionist to “Hold all my calls while I’m in this 
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meeting,” should there be an emergency or if the boss should call, you’ll be 
interrupted. Obviously, some interruptions will always occur and require immedi¬ 
ate service. 

Addressing Modes 


There are several data accessing methods available to you. The 8088 micro¬ 
processor allows any of the following modes to be used when accessing data. The 
general format of addressing data is: 

□P-CODE destination, source 

Register Direct ■ 

Register direct addressing is used to manipulate data directly contained in two 
specific registers. For example: 

ADD BX,CX <Add the contents of CX to BX> 

MOV AL, BL -CMove the 8-bit value in BL to AL> 

MOV CX,AX -CMove the 16-bit value in AX to CX> 

Immediate 

Tmm pdiate addressing operates on a constant value, which is contained in the 
instruction itself: 

MOVE AX, 1000 <Moves a word of data (1000) to AX)- 

MOV AL, -1 -CMoves the constant -1 into AL> 

ADD AL, 10 <Adds 10 to AL> 

ADD AX, THOUS -CAdds the value of THOUS (1000) to AX> 

Memory Direct —— 

In memory direct addressing, the operand’s address is specified in the instruction: 

MOV AX,COUNTER <Moves the contents of the memory location 

COUNTER to AX> 

MOV COUNTER, AX -CMove the contents of AX to the memory location 

l;uunter> 
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Memory Direct with Index ' 

This form of memory addressing accesses values stored in memory by specifying 
the start of the data structure (as in the direct addressing mode above) as an offset 
contained in DI or SI. For example: 

MOV SlyOSH displacement of S 

MOV AXI COUNTER CSI3 5 Moves the contents of the memory location 

5 (COUNTER +e) into AX. 


Register Indirect " 

In register indirect addressing, the BX, BP, SI, or DI register contains the address of 
an operand. Using the memory location COUNTER from the previous example, 
one of the registers is loaded with the address of the location COUNTER. This can 
be done in one of two ways: 

1) LEA SI,COUNTER <Lo«ds the effective addres of COUNTER 

into the SI register> 


or; 

2) MOV SI,OFFSET COUNTER <Loads the segment offset value of 

COUNTER into SI> 

Once the address has been loaded into the SI, DI, BP, or BX register, you can use the 
register to access data stored at that location. For example: 


MOV AX, CSIl ■€Moves the contents from the address pointed to by 
SI into the AX register> 

ADD AX,CSI3 <Adds the contents of the address pointed to by SI 
to the AX register> 


ADD CBX3,AX *CAdd the contents of AX to the memory location 
pointed to by BX> 


Based Index (Register 
Indirect with Index) . 

This mode of addressing accesses an operand in a data structure, pointed to by BX 
or BP, located at the offset specified by either DI or SI. For example, suppose DI 
contains the value 2, and BX contains the start address of a data structure that 
includes employees’ hourly wages. The instruction MOV AX, [BX + DI] would load 
AX with a third employee’s wages. Figure 3-11 illustrates register indirect with 
index addressing. Intel refers to this mode of addressing as based indexed address- 
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ing, because the effective address is calculated from the contents of one of the base 
registers and an index register. 


MOV DX,pXiSI] DS+BX+SI-EffectiveAddress 

Register Memory 

DS-► Segment Start 

Base Operand 

Target Operand 



Based index addressing aiiows the programmer to specify an effective address 
as the sum of a base register and an index register. A displacement vaiue may 
also be specified. 


Figure 3-11 Register Indirect with Index 


Register Indirect 
Indexed with 


Displacement Addressing ■ ' 

The last addressing mode is another variation of based index addressing. In register 
indirect with index plus displacement, the effective address is calculated as the sum 
of the contents of BX or BP, plm the contents of SI or DI, plus the specified 
displacement value. For example: 

MOV ftX,CBX+DI+ei <Moves the contents of the memory location 

pointed to by the sum of BX, DI, and S into 
the RX register> 

move CBX+DI+£3,CX <Moves the contents of CX into the memory 

location specified by the sum of BX DI +2> 


The displacement can also be specified in the form a symbolic name as: MOV 
MY_BYTE[BX1 [DIH-2,CX. 

Memory-to-memory data transfers and manipulations are not allowed, nor are 
operations that specify a constant value as the destination operand. 
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Address Calculation Time '■ 

As you might have guessed, the calculation of an effective address takes a certain 
amount of time. The exact time required for address calculation depends on the 
addressing mode chosen. Table 3-2 can be used to determine effective address 
calculation times. 

In Appendix B, you’ll find the execution times of each 8088 instruction. The EA 
calculation time must be added to the instruction’s execution time to determine 
the total execution time. For example, the NEG instruction lists an execution time 
for a memory operand as 16 + EA. In all cases, four clock cycles must be added to 
the value shown (16, in this example), if the operation requires a l6-bit (word) 
transfer. The worst case, or longest execution time, for this instruction would then 
be 32 (16 -t- 4 -I- 12) clock cycles. The fastest execution time for this instruction 
would be when a register is specified as the operand. Since there is no effective 
address to be calculated, the instruction executes in three clock cycles. 


Table 3-2 


EA Components 

Clocks* 

Displacements Only 

6 


Base or Index Only 

5 

(BX,BP,SI,DI) 

Displacement + Base or Index 

9 

(BX,BP,SI,DI) 

Base + Index 

7 

(BP + DI,BX + SI) 


8 

(BP + SI,BX + DI) 

Base + Index 4- Displacement 

11 

(BP + DI + DISP) 

(BP + SI + DISP) 


12 

(BX + SI + DISP) 

(BX + DI + DISP) 


‘Add two clocks for segment override. 

IBM system clock = 210 ns (nanoseconds) 
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1. There are_main sections to a computer system. 

2. The main sections are the_,_, and the_ 

section. 

3. The_section acts like a mailman to the other sections of a 

computer system. 

4. The 8088 contains_independent internal units. 

5. The_removes instructions from the_ 

and decodes and executes the instructions. 

6. The 8088 flag register is_bits wide. 

7. The ALU of the 8088 is_bits wide. 

8. The maximum amount of memory the 8088 can directly address is 
_bytes. 

9. The Basic Input/Output System is contained in the system’s 

A. RAM or 

B. ROM. 

10. The 8088 views the total memory space as being divided into_ 

byte_. 

11. An effective address is generated by taking the base value found in one of the 

_registers and by adding an_to that value. 

12. Name at least two uses for the stack. 

13. The 8088 is capable of generating_1/O addresses. 

14. The 8088 is operated in the_mode in the IBM PC. 

15. Name one difference between minimum and maximum mode of operation. 

16. The data bus of the 8088 is_bits wide. 

17. The data bus of the 8086 is_bits wide. 

18. Low memory in the IBM PC is dedicated to storing_vectors. 

19. What is the difference between a microprocessor and a microcomputer? 

20. There are_l6-bit-wide registers in the 8088. 
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21. The data registers of the 8088 are _, _, 

_, and_. 

22. There are_index registers. 

2 3. There are_pointer registers. 

24. There are_segment registers: _, _, 

_, and_. 

25. The extra segment must always point to the stack (True or False). 

26. _and_form a pointer to the next instruction to be 

executed. 

27. The Z flag indicates that nothing is going on (True or False). 

28. When the 8088 is interrupted, it will save the _register, 

_register and the_register on the stack. 

29. Some interrupts may be_. When this is done, the 8088 will/will 

not respond to external interrupts (circle the correct answer). 

30. Name four addressing modes the 8088 is capable of employing. 

31. An instruction’s total execution time can be determined by looking up the 

instruction execution time in the_, and adding the_ 

calculation time to it. 





We’ve covered a lot of ground in the first three chapters. Now it is time to tie the 
loose ends together (as far as the 8088 is concerned). We already know that the 
assembler translates source statements into the machine code the 8088 under¬ 
stands, but we have not described the 8088’s instruction set, the commands which, 
when used other commands, create a program. 

If you are an experienced assembly language programmer, you may be surprised to 
see some of the powerful instructions in the 8088’s repertoire. There is much 
similarity between many high level languages and some of the instructions the 
8088 is capable of executing. For example, you can implement functions similar to 
BASIC’s FOR and NEXT iteration loops. 

I have already used some of the 8088’s instructions in previous chapters. By doing 
so, it is a bit like putting the proverbial cart before the horse. In order to illustrate 
an assembly language program as was done in the programming examples of 
Chapters 1 and 2, it was necessary to use the instructions which I am about to 
discuss. After reading this chapter, you should go back to the previous chapters and 
review the examples presented. 

I also mentioned in Chapter 2 that an immediate value could not be used as a 
destination operand in an instruction. The reason is that it would make little sense 
to use immediate addressing with a destination operand of a constant. As the 
general format for a source code statement is: 71 
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OP-CODE destination, source 


the destination operand would have to be capable of being altered. Immediate 
operands are constant values which are specified within the instruction. There¬ 
fore, they cannot be used as destination operands. 

However, nearly all instructions allow you, the programmer, to specify memory or 
register operands as either source or destination operands. What if you want to add 
20 to the contents of the memory location labeled COUNTER? Most processors 
first require that the value be fetched from memory and loaded into the 
accumulator. Then 20 would be added to the value in the accumulator and the new 
value saved in memory. The operation would require at least two instructions and 
perhaps three on most microprocessors. The 8088 accomplishes this operation in 
one instruction: ADD COUNTER,20. Allowing register and memory operands to 
be used as either source or destination operands in an instruction results in an 
overall reduction of the machine code generated by the assembler. 



Table 4-1 shows the 8088 instruction set divided into six major groups. 


Table 4-1 

8088 Instruction Groups 


Group 1 




Data Transfer Instructions 


General Purpose 

Input/Output 

MOV 

Move byte or word 

IN 

Input byte or word 

PUSH 

Push word onto stack 

OUT 

OUTPUT"" " " " 

POP 

Pop word off stack 



XCHG 

Exchange byte or word 



XLAT 

Translate byte 



Address Object 

Flag Transfer 

LEA 

Load effective address 

LAHF 

Load AH from flags 

LDS 

Load pointer using DS 

SAHF 

Save AH in flags 

LES 

Load pointer using ES 

PUSHF 

Push flags 



POPF 

Pop flags 
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Qroup 2 

Arithmetic Instructions 

Addition 

ADD 

Add byte or word 

ADC 

Add byte or word with carry 

INC 

Increment byte or word by 1 

AAA 

ASCII adjust for addition 

DAA 

Decimal adjust for addition 

Subtraction 

SUB 

Subtract byte or word 

SBB 

Subtract byte or word with borrow 

DEC 

Decrement byte or word by 1 

NEG 

Negate byte or word 

CMP 

Compare byte or word 

AAS 

ASCII adjust for subtraction 

DAS 

Decimal adjust for subtraction 

Multiplication 

MUL 

Multiply byte or word unsigned 

IMUL 

I nteger multiply byte or word 

AAM 

ASCII adjust for multiply 

Division 

DIV 

Divide byte or word (unsigned) 

IDIV 

Divide byte or word (signed) 

AAD 

ASCII adjust for division 

CBW 

Convert byte to word 

CWD 

Convert word to doubleword 


Groups 


Logical, Shift, and Rotate 

Logicals 



Complement byte or word 
Perform logical AND on byte or word 
Perform logical OR on byte or word 
Perform logical XOR on byte or word 
Perform logical TEST (AND) on byte or word 


continued 
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Group 4 

String Instructions 

__ _ ______i 

REP 

Repeat 


REPBREPZ 

Repeat while equal to zero 


REPNE/REPNZ 

Repeat while not equal to zero 


MOVS 

Move byte or word string 


MOVSB/MOVSW 

Move byte or word string 


CMPS 

Compare byte or word string 


SCAS 

Scan byte or word string 


LCDS 

Load byte or word string 


STOS 

Store byte or word string 



Group 5 



Program Transfer Instructions 


Unconditional Transfer Instructions 

CALL 

Cali procedure 


RET 

Return from procedure 


JMP 

Jump 



Conditional Transfer Instructions 



Jump if 

Flag Condition 

JA/JNBE 

Jump if above/not below 

(CSorZF)=0 

JAE/JNB 

Jump If above or equal/not below 

CF=0 

JB/JNAE 

Jump If below/not above or equal 

CF=1 

JBE/JNA 

Jump if below or equal/not above 

(CForZF)=1 

JC 

Jump if carry 

CF=1 

JE/JZ 

Jump if equal/zero 

ZF=1 

JG/JNLE 

Jump If (<)/not > nor = 

((SFxorOF)orZF)=0 

JGE/JNL 

Jump if greater or =/not < 

(SFxorOF)=0 

JL/JNGE 

Jump if less/not greater nor equal 

(SFxorOF)=1 

JLE/JNG 

Jump if < or =/not > 

((SFxorOF)orZF) = 1 

JNC 

Jump if not carry 

CF=0 

JNE/JNZ 

Jump If not equal/not zero 

ZF=0 

JNO 

Jump If not overflow 

OF=0 

JNP/JPO 

Jump if not parity/parity odd 

PF=0 

JNS 

Jump If not sign 

SF=0 

JO 

Jump If overflow 

OF=1 

JP/JPE 

Jump if parity/parity even 

PF = 1 

JS 

Jump if sign 

SF = 1 

Iteration Control Instructions 

LOOP 

Loop 


LOOPE/LOOPZ 

Loop if equal/zero 


LOOPNE/LOOPNZ 

Loop if not equal/not zero 


JCXZ 

Jump if register CX=0 


Interrupts 


Interrupt 

Interrupt If overflow 
Interrupt return 



















8088 Instruction Set 75 


Group 6 

Processor Control Instructions 

Flag Operations 

STC 

Set carry flag 

CLC 

Clear carry flag 

CMC 

Complement carry flag 

STD 

Set direction flag 

CLD 

Clear direction flag 

STI 

Set interrupt enable flag 

CLI 

Clear interrupt enable flag 

External Synchronization 

HLT 

Halt 

WAIT 

Wait 

ESC 

Escape 

LOCK 

Lock bus during next instruction 

No Operation 

NOP 

No Operation 


Data Transfer 
Instructions 


These instructions move data in and out of memory and the 8088’s registers. They 
also move data contained in AL or AX to or from an I/O port. Intel further 
categorizes the data transfer instructions as: 

A. general purpose data transfers, 

B. I/O port transfers, 

C. address-object transfers, and 

D. flag register transfers 

Arithmetic Instructions 

Arithmetic instructions operate on signed or unsigned numeric operands in either 
binary or packed or unpacked BCD format. 

Bit Manipulation Instructions 

This group of instructions performs logical, shift, and rotate operations on byte or 
word operands. 

Control and Transfer Instructions 

The control and transfer instructions allow conditional or unconditional jumps to 
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other parts of the program. Also included in this group are interrupt instructions 
and status flag operations. 

String Manipulation Instructions 

Possibly the most powerful of all the 8088’s instruction types are those used for 
string manipulation. You can scan, move, or compare strings of data that are up to 
64 k bytes in length in these instructions. 

Processor Control Instructions 

This group of instructions allows you to set and clear the carry, direction, and 
interrupt flags in the 8088’s status register. There are also instructions which 
synchronize the 8088 to other processors (referred to as co-processors) and exter¬ 
nal events. 



The first group of instructions consists of those that move data from one place to 
another in the PC. They move data either to or from: 

1. Memory and registers, 

2. One register and another register, or 

3. The AL or AX register and an I/O port. 

The data transfer instructions are the most fundamental and the most easily 
understood and are therefore the first ones I’ll discuss. All of the instructions (for 
all groups) are listed alphabetically in Appendix C. They are reprinted in the 
appendix with the permission of Intel Corporation. The information which fol¬ 
lows paraphrases the information contained in the appendix and expands upon it 
where necessary. 


General Purpose 
Data Transfers 


MOV- 

Format: MOV destination, source 


The MOV (move) instruction transfers either 8 bits (1 byte) or 16 bits (1 word) of data 
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from the source to the destination operand. Any of the addressing modes discussed 
in Chapter 2 can be used to effect the transfer. This is the most frequently used 
8088 instruction. Some examples of the MOV instruction are: 

;Move the contents of DX to AX. 

;Move the 8--bit contents of CL to BL 
;Move the contents of memory to AX 
;Move the constant 16 (decimal) to AL. 

;Move the contents of AX to the 
;Extra segment register. 


MOV AX,DX 
MOV BL,CL 
MOV AX,COUNTER 
MOV AL,10H 
MOV ES,AX 


The following forms of the MOV instruction are not allowed: 


MOV 10H,AL 


MOV CS, AX 


MOV ES,A000H 


MOV NEW^COUNT,COUNTER 


5 You cannot use a constant as the 
;destination. 

5 You cannot use the code segment 
;register as the destination operand. 

5 You cannot use a constant value 
;as the source operand and specify 
;a segment register as the destination. 
;You cannot use memory as both the 
;source and destination operands. 


Let’s examine each of the illegal MOVs in greater detail. I’ve already discussed why 
an immediate value cannot be used as the destination operand, but why can’t we 
use the code segment register as the destination? Since the code segment register 
contains the base address of the program currently being executed and the IP 
register contains the offset into the code segment of the next instruction to be 
executed, altering CS produces a meaningless combination of the segment register 
and the instruction pointer. CS would be pointing to some new segment, while IP 
would still be pointing to the old offset of the old segment. Whatever IP would be 
pointing to in the new segment would not be what was desired; therefore, this 
form of the MOV instruction is not allowed. 

The segment registers cannot be loaded from an immediate value in the source 
operand either. The assembler associates certain segment registers with the three 
types of segments in your program (code, data, and stack). In order to satisfy this 
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assumption you must load the start address of the segment into one of the general 
purpose registers, and then transfer this value to the desired segment register. For 
example: 

MOV AX,MY_DftTA ;Load the start address of the data 

;Segment into PX. 

MOV DS,PX 5 Establish DS as pointer to MY_DPTP 


This is the method you should use to load the DS, ES, and SS registers with the 
starting address of a segment of memory. Remember, the segment registers shift 
this value left by 4 bit positions and append a low order nibble of zeros to the 
segment address (see Chapter 2). 

Memory-to-memory transfers are also not allowed. A value must first be moved 
into one of the CPU’s registers, and then written to the new location. 

PUSH^--- 


Format: PUSH source 


The PUSH instruction allows you to temporarily save data on the stack. This 
method of temporary data storage is often used when you want a register to 
perform some type of operation, but you do not want to destroy its current 
contents. The PUSH instruction can also be used to pass parameters (data) to 
subroutines or procedures. Once in the subroutine, the BP register is used to access 
the parameters that have been pushed onto the stack. 

When the 8088 encounters the PUSH instruction, the stack pointer (SP) is decre¬ 
mented by two and the l6-bit source operand is transferred to the stack location 
pointed to by SP. 

POP-— 

I Format: POP destination 


The POP instruction is the complement of the PUSH instruction. It allows you to 
retrieve information that has been saved, or pushed, on the stack. When the 8088 
encounters the POP instruction, the word pointed to by the stack pointer is 
transferred to the destination operand, which can be any l6-bit register (except CS) 
or a memory operand. SP is then incremented by two, and points to the new top of 
the stack. 

A common mistake is neglecting to pop all the information which was pushed onto 
the stack. When a procedure is called by using the CALL instruction (which I’ll 
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discuss later in this chapter), the return address of the calling program is automati¬ 
cally saved on the stack by the 8088. 

To exit the procedure and return to next the instruction in the program, the 
procedure must issue a RET, or return, instruction. When the 8088 encounters the 
RET instruction, the value pointed to by SP is transferred to the instruction pointer 
IP, assuming that both the main program and the procedure reside in the same code 
segment (intrasegment). 

If the procedure and the calling program are not within the same segment (interseg¬ 
ment), the segment address as contained in the CS register is also saved on the 
stack. When the intersegment RET is encountered, the word pointed to by SP is 
popped off the stack into the instruction pointer. The stack is incremented by two, 
and the word pointed to by SP is popped from the stack into the code segment 
register. The stack pointer is again incremented by two to point to the new top of 
stack. 

What would happen if you wanted to use AX in the procedure, but AX might 
contain a value used in the main program? Certainly you should save the value of 
AX prior to using the register in the procedure. Consider the following portion of 
code! 

MAIN PROGRAM: CALL MY.PROCEDURE ;Call a subroutine. 

MOV BXyAX 5 The procedure should return 

;here. 

MOV ftX,CX ;etc. 

The main program calls the procedure named MY_PROCEDURE. Assume for the 
moment that both the calling program and the procedure reside in the same code 
segment. The offset address into the current code segment is contained in IP and is 
automatically saved on the stack when the 8088 encounters the CALL instruction. 
A new offset value, which is the offset address of MY_PROCEDURE, becomes the 
new value of the instruction pointer IP. After the procedure is finished, control 
should return to the main program at the instruction which moves the contents of 
AX to BX. 

Consider what would happen if the procedure were written in the following 
manner: 


MY_PRQCEDURE PROC NEAR 

PUSH PX ;Save the value of 

. . ;<The program statements of the 


continued 
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, . ;procedur'«. > 

ret jOh - Oh! 

MY.PROCEDURE ENDP 

Here AX was saved on the stack and never restored the stack prior to exiting the 
procedure. When the RET instruction is executed, the 8088 transfers the value of 
AX that was pushed on the stack to the instruction pointer. Where do you think the 
8088 will return to? Certainly not to the MOV instruction in the main program. It 
will try to execute whatever it finds at the memory location specified by the 
combination of CS and IP. Since the value in IP is whatever was in AX, chances are 
that the combination will not point to anything coherent. 

The rule is: For every PUSH there must be a POP, and for every POP there must be a 
PUSH. The procedure should have been written as: 

MY_PROCEDURE PROC NE«R 
PUSH PX 


POP PX 
RET 

MY_PROCEDURE ENDP 

You may want to save more than just one register when a procedure has been 
called. If this is the case, you must pop the words in the opposite order of that in 
which they were saved. Remember that the last value pushed on the stack is the 
first value to be popped. 

MY_PROCEDURE PROC NEPR 
PUSH PX 
PUSH CX 
PUSH BX 


POP BX ;Restore the registers 


}Save PX, CX, and BX 

;A11 registers have been saved 
:Now execute procedure 


;Save PX 

;<Rest of the procedure> 
$etc. 

;Restore PX 

;and return to caller. 


PQP CX 
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POP PX 

RET ;and return to caller. 

MY PROCEDURE ENDP 


Figure 4-1 illustrates the stack usage due to the PUSH and POP instructions. (See 
also RET.) 


MOV AX, 0FF82H 
PUSH AX —^ 

Stack Segment 




AH AL 



AX = FF 82 

— 1 ^ 



1 


^ Top of wtdCK 

(SP) 

' 1 ► 

FF 

SP-► 



Top of Stack 
before PUSH 



(a) After PUSH 

Stack Segment 


POP AX 







82 

—► AL 


FF 

AH 



AX = 0FF82H 

Top of Stack 
after POP 




(b) After POP 




Figure 4-1 Stack usage during PUSH and POP 
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XCHG- 

I Format: XCHG destination,source 


The exchange instruction is used to exchange either byte or word data between the 
source and destination operands. Legal combinations of the XCHG instruction are: 


XCHG 

PX,CX 

;Exchange the contents of 

PX and CX 

XCHG 

r 

n 

r 

;Exchange the contents of 

PL and CL 

XCHG 

ftL,MEMORY_aBITS 

;Exchange 8 bits (byte) of PL and 



5 the contents of a memory 

location 

XCHG 

PX,MEM0RY_16BITS 

; Exchange 16 bits (word) 

between 



;PX and memory. 


XCHG 

px, csn 

;Exchange the contents of 

PX and 


;the word in memory pointed to by SI 


You cannot use the segment registers as the operands of the XCHG instruction. For 
example: 

XCHG CS,DS ;Is illegal 

XCHG DS,MEMORY.16BITS ;ls also illegal. 


XLAT 


Format: XLAT translation table 


The translate instruction replaces the contents of the AL register with a byte from a 
translation table. The offset into the table is assumed to be in AL, and the base 
address (start address) of the table must be in the BX register prior to using the 
XLAT instruction. This instruction is commonly used in character code transla¬ 
tions. For example, if you want to convert an ASCII character to Baudot, you could 
use the XLAT instruction to perform the conversion. 
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I/O Port Transfers 


IN and OUT 


Format: IN accumulator,port 

OUT port, accumulator 


The IN instruction transfers either byte or word values from a specified port 
number to the accumulator. Conversely, the OUT instruction will send or transfer 
data from the accumulator to the specified port number. The port number can 
either be specified as part of the instruction (an immediate 8-bit value), or it can be 
specified indirectly by placing the port number in the DX register. Immediate port 
addressing allows up to 256 ports to be accessed (O-OFFH), while using the indirect 
method allows up to 65,535 ports to be accessed (O-OFFFFH). 

The IBM PC communicates to various peripheral devices such as the keyboard, 
video display, cassette, and disk drives via port addresses. For example, port 
addresses 3F0-3F7H are assigned to the diskette controller. Ports 378-37AH are 
used to communicate with the printer interface, as are ports 3BCH-3BEH when 
you are using the printer port supplied on the monochrome display and printer 
adapter board (see the IBM technical manual for more details). Some examples of 
how the IN and OUT instructions may be used are: 


PRINTER EQU 3BCH 

PRINTER_STftT EQU 3BDH 
MOV DX,PRINTER 
MOV BX,PRINTER.STRT 
MOV fll_, ’ 

OUT DX,ftL 
XCH6 DX,BX 
IN PL,DX 


;Printer port on monochrome display and 
;printer adapter board. 

5 Printer status port. 

;Port address to DX 
5 Printer status port into BX 
;riove ASCII letter A into AL 
;Send character in AL to the printer. 

;Exchange BX and DX. DX now ^^status port 
IGet the printer’s status. 


Other examples IN and OUT are: 


IN AX,0A0H 


IN AL,0B1H 
OUT 0B3H,AX 


;Input a word of data from port A0H 
;Input a byte of data from port BIH 
;Output the word in AX to port B3H. 








84 80881IBM PC Assembly Language Programming 


Address-Object 

Transfers 


Address-object transfers send address pointers to a specified register or pair of 
registers. The address pointers are then used as segment and offset pointers in 
calculating absolute memory addresses. 

lea- 


Format: LEA destination,source 


The load effective address (LEA) instruction is used to transfer the offset address of 
the source operand to the specified l6-bit register. The source register is always a 
memory operand. You could also use the MOV instruction with the offset operator 
to move an address value rather than the contents of a memory location into a 
register. For example: 

MOV SI,OFFSET SOURCE_DftTfl 
and - LEO SI,SOURCE_DftTfl 

accomplish the same task; transferring the address offset of SOURCE_DATA to the 
SI register. 

String instructions, which will be discussed later in this chapter, require SI and DI 
to point to memory addresses. LEA is used to move address offsets into the 
registers. LEA is preferred over the MOV with offset qualifier, as it is perfectly clear 
when LEA is used that you are moving an address and not the contents of the source 
operand to a register. Additionally, LEA allows you to specify an address value 
indirectly, using the contents of another register. For example: 

LEO BX,TRftNS_TfiBLECBP3CDI3 


could be used to load the address of an entry into a translation table. In this instance 
the address value is the sum of the memory address TRANS_TABLE plus the 
contents of BP and DI. If BP contained 3, and SI contained 4, then the effective 
address is equal to TRANS_TABLE + 7, or the address of the eighth entry in the 
table. The MOV with Offset operator does not allow this flexibility in accessing the 
source operand. 
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LDS- 

Format: LDS destination,source 


The LDS (load pointer using DS) instruction transfers a 32-bit double word segment 
and offset value from the source operand to DS and the specified l6-bit register. For 
example: 

LDS SI,MY_DfiTft 


loads SI with the offset value of MY_DATA and DS with the segment address of the 
segment where MY_DATA resides. This instruction is commonly used to switch 
the DS register to a new data segment and establish a pointer in SI prior to using 
string instructions which require this register combination to access data. Rather 
than loading AX with the start address of a new data segment and transferring the 
address value from AX to DS, LDS accomplishes the same function in one instruc¬ 
tion. Additionally, it establishes an offset value that would otherwise require yet 
another instruction. 

Like LEA, LDS allows you to add a displacement to the source operand: 


MOV DIy05 jMove the value of 5 into DI 

LDS BX,MY_DftTACDI3 jMove the double word stored at 

5 MY_DftTft + 5 into DS and BX. 


LES- 

Format: LES destination, source 


LES (Load pointer using ES) operates in the same manner as the LDS instruction, 
with the exception that the segment address is transferred to the extra segment 
register, ES, rather than the data segment register, DS. Similar to LDS, which 
establishes source pointers to be used by the 8088’s string instructions, LES can be 
used to set up the ES and DI registers with pointers to the destination string: 


LES DlyY0UR_DATA ;Loads ES with the segment address of 

5Y0UR_DftTA, and DI with the offset 


;address of the operand. 
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Flag Register Transfers 


The 8088 contains instructions that allow the programmer to transfer a portion of 
the l6-bit flag register to or from the high order half of the accumulator or to 
transfer the flag bits to or from the stack. 

LAHF- 


Format: LAHF 


LAHF (Load register AH from Flags) transfers the carry flag (CF), parity flag (PF), 
auxiliary carry flag (AF), zero flag (ZF), and sign flag (SF) into bit positions 7,6,4, 2, 
and 0 of the AH register. You may wonder why these are the only flags transferred 
to AH. The reason is to retain compatibility with the older 8080 and 8085 8-bit 
processors from Intel; these are the status flags used by the 8080/8085. 

SAHF- 


Format: SAHF 


SAHF (Store register AH into Flags) transfers bits 7, 6, 4, 2, and 0 from AH to the 
status flag register. Again, this instruction was added to the 8088 to insure com¬ 
patibility with the 8080 and 8085 processors. 

PUSHF and POPF- 


Format: PUSHF 
POPF 


PUSHF (Push Flags) saves the flag bits in the l6-bit flag register onto the stack. The 
stack pointer is decremented by two, and the contents of the flag register are saved 
at the location pointed to by SP. POPF transfers the flag bits contained in the l6-bit 
value pointed to by the stack pointer to the appropriate bit positions of the flag 
register. SP is then incremented by two to point to the new top of the stack. 

You would use the PUSHF instruction whenever it is necessary to preserve the 
current contents of the flag register. 

Consider the following code: 

MOV flL,BYTE_VftL ;Move a byte into OL 

CMP PL|BL ;Ib it lower or higher? 

CALL PROCEDURE_i ;6o do something with AL 


JB LOW_VAL 


;AL BL then jump. 
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What’s wrong with the program example above? 

It’s a pretty good bet that the procedure will use an instruction or two that will 
change the flags. If the flag register is not saved on entering the procedure and 
restored prior to exiting the routine, the flags will not be accurate when control is 
returned to the main program. PUSHF and POPF can be used to save and restore the 
flags on entering and exiting the procedure. 

Program errors such as the one above are common to novice programmers. A 
better solution to the problem is to keep a simple rule in mind: Immediately follow 
the flag setting instruction with a conditional transfer instruction like this: 


MOV ftL,BYTE_VflL 
CMP PL, BL 
JB LQW_VflL 
CPLL PROCEDURE.1 


5 Fetch value from memory 
;Is Al.<BL? 

5 G 0 to another routine if it is. 
;Else go do something with Al. 



With this group of instructions, the 8088 is able to perform addition, subtraction, 
multiplication, and division. The operands may be signed or unsigned byte or 
word values. All instructions treat the data operands as binary values, although 
corrective instructions allow you to perform arithmetic operations on ASCII and 
PCD data. 

The carry, auxiliary carry, zero, sign, parity, and overflow flags are set or reset 
according to the result of the operation. See the section on the flag register in 
Chapter 2 for a description of the behavior of each of these flags. 


Addition 


ADD - 

I Format: ADD destination, source 


The ADD instruction adds the source to the destination operand and places the 
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result into the destination operand. The operands may be byte or word values; they 
may both be registers, or they may be a memory and register combination. The 
operands may be signed or unsigned binary data. Some examples of the ADD 
instruction are: 


PDD 

DL,3FH 

;Add 63 to the contents 

of 

the DL 

register. 



;<DL=>DL+3FH) 




ADD 

AX, BX 

;Add the contents of BX 

to 

AX(AX* 

>AX-i-BX) 

ADD 

WORD_VAL,DX 

5 Add the contents of DX 

to 

memory 

location 



5W0RD_VAL. (W0RD_VAL«W0RD^VAL+DX) 


ADD 

BL,BYTE PTR WORD^VAL 

;ADD the low order byte 

of 

the 



;word stored at WORD_VftL to ©L- 

In this example, the PTR operator was used to specify a byte value stored at 
WORD_VAL. This is a type override; it is used to override the type attribute of an 
operand. Each operand, when defined, has an attribute associated with its defini¬ 
tion. In this particular case, WORD_VAL has a type attribute of word; it is a l6-bit, 
or 2-byte, value. In order to operate on either low order half of WORD_VAL, it is 
necessary to use the pointer override prefix. 

If you were to code the instruction as ADD BL,WORD_VAL, the assembler would 
generate an error, because the attribute types of the operands do not match. I’ll 
discuss this and other override prefixes in the next chapter. I did, however, want to 
show you that 1 byte of a word operand can be isolated and added to another 8-bit 
operand. 


ADC 


Format: ADC destination,source 


ADC (add with carry) is used to add the source to the destination operand and add 1 
to the result if the carry flag is set. The result is placed in the destination operand. 
The operands may be signed or unsigned binary data. 

Assume for a moment that you want to add the two 32-bit numbers, as illustrated in 
Figure 4-2. The destination operand(s) will be in memory at WORD_ONE (low 
order 16 bits) and at WORD_TWO (high order 16 bits). The 32-bit operand you 
want to add to these memory locations is in the AX (low order word) and the BX 
(high order word) registers. The following set of instructions produces the correct 
result: 

ADD WORD.ONE,RX jfidd OX to WORD_ONE without carry 

ODC WQRD_TWO,BX jOdd BX and Carry bit to WDRD.TWO. 
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Add 70319028 (Hex) and 3AC5E045 (Hex) 

1st Operand (High Order) - 7031H = 0111 0000 0011 0001 (Binary) 

2nd Operand (High Order) - 3AC5H = 0011 10101100 0101 (Binary) 

1st Operand (Low Order) - 9028H = 1001 0000 00101000 (Binary) 

2nd Operand (Low Order) - E045H = 1110 0000 0100 0101 (Binary) 

Add Low Order Operands: 1001 0000 00101000 

ADDAX.BX 1110000001000101 

Carry-> 1 0111000001101101 

Add High Order Operands: 0111 0000 0011 0001 

(WithCarry) 0011 10101100 0101 

__J 

1010101011110111 

ADCCX.DX 

Result in CX:AX CX AX 

101010101111 0111 0111 000001101101 
2AF7(Hex) 706D(Hex) 

Check Binary Add With Hex 
Add 

70319028 (Hex) 

+ 3AC5E045 (Hex) 

AAF7706D (Hex) 

Figure 4*2 32 bit ADD.AOC Example 

As the ADD instruction produced a carry out of bit 15, the ADC accounts for the 
carry and adds 1 to the high order word of the result. Multiple precision addition is 
possible using the ADC instruction. 

INC —--—- 

Format : INC destination __ 

The increment instruction is used to add 1 to the destination operand. The incre¬ 
ment instruction does not affect the carry flag (CF), but it does update AF, OF, PF, 
SF, and ZF. The operand may be either an unsigned byte or word value. Some 
examples of the INC instruction are: 

INC WORD_VftL ;Increment the 16 bit contents of 

5W0RD_V«L 

INC BYTE_VAL ;Increment the 8 bit contents of 

;BYTE^VAL 


continued 
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INC CX ;Increment the value in CX 

INC AL ;Increment AL 

The increment instruction adds 1 to an operand faster than the ADD instruction 
does. The maximum execution time is encountered when incrementing an oper¬ 
and in memory, yet even this is faster than ADD MEM_VAL,1. Compare the 
execution times for these operations as given in Appendix B. 


AAA 


Format: AAA 


AAA (ASCII Adjust for Addition) corrects the result in AL after adding two 
unpacked BCD numbers. In Chapter 1,1 demonstrated that after adding two BCD 
digits, the result may not be correct. The CPU treats all operands as binary data. We 
formulated the rule that if the result in the low order nibble was greater than 9, or if 
the auxiliary carry flag was set, you must add 6 to the low order nibble of the result 
to correct for the addition. 

If the above conditions are met, AAA adds 6 to the low order nibble of AL, clears the 
high order nibble of AL, and adds 1 to the contents of AH. This in effect produces an 
unpacked BCD value in AH and AL. Consider the following statements: 

MOV AX,0009 ;AL» 09 and 00 

ADD AL,04H 5 AL now = 0DH which is not BCD digit 

AAA ;AL now « 03 and AH* 01(AX*0103).This is 

;the correct result of 9+4 * 13 (decimal). 

DAA . 


Format: DAA 


DAA (Decimal Adjust for Addition), corrects the value in AL from a previous 
addition of two packed BCD operands. If the value in AL is greater than 9 or if the 
auxiliary flag is set, 6 is added to AL and AF is set to 1. Also, if AL is greater than 9FH 
or if CF is set, then 60H is added to AL, thereby correcting the high order nibble of 
AL, and CF is set to 1. The following examples illustrate the DAA instruction: 


Example 

' 1 



MOV 

AL,39H 

5 AL * 

39 BCD 

ADD 

AL,16H 

5 AL * 

SIH, the desired result should be 57 



;BCD. 








8088 Instruction Set 91 


DAA 


;ftL now = ftL + 06 « 57 


Example E: 

MOV ftL,79H 
ftDD ftL,39H 
DAA 


;AL * 79 BCD. 

5 Add 79 + 39. AL now * B2H 

;Add 06 to AL, AL now BdH 

;Also AAA adds 60H to B8H, AL now * 18 and 

;the carry flag is set to 1. 


In Example 2, 79 BCD plus 39 BCD should yield a result of 118 BCD. Due to the 
binary addition of 79H and 39H, the result is B2H. DAA compensates for this error 
in packed BCD addition. The carry flag, which is set due to the carry out of bit 7 of 
AL, can be used to increment another register or memory operand to yield the 
three-digit BCD result of 118. 


Subtraction 


SUB- 

Format: SUB destination, source 

The subtraction instruction subtracts the source operand from the destination 
operand and places the result in the destination operand. The operands may be 
either signed or unsigned byte or word values. Some examples of the SUB instruc¬ 
tion are as follows: 


SUB 

AL,30H 

;Subtract 

30H from AL. 




SUB 

BX,CX 

5 Subtract 

the contents 

of 

CX from 

the 



jcontents 

of BX. 




SUB 

AX, WORD^VAL 

;Subtract 

the contents 

of 

the memory 



;location 

U»0RD_VAL 






from AX. 





SUB 

BYTE^VAL,AL 

;Subtract 

the contents 

of 

AL from 

the 


;memory location BYTE_VAL. 
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SBB- 

Format: SBB destination,source 


Subtract with borrow (SBB) subtracts the source operand from the destination 
operand and then subtracts 1 from the result if the carry flag is set. Just as the ADC 
instruction can be used to perform multiple precision addition, SBB performs 
multiple precision subtraction. An example of using SBB to perform multiple 
precision subtraction is: 

SUB AXyBX jFirst subtract the low order 16 bits 

SBB DXyCX ;then subtract the high order 16 bits 

5and the carry bit. 


When would the carry be set from a SUB operation? Anytime the source operand is 
larger than the destination. In the example above, the carry flag is set if AX is less 
than the contents of BX. The source and destination operands can be either signed 
or unsigned byte or word values. 

AAS . 


Format: AAS 


The ASCII Adjust for Subtraction (AAS) instruction corrects the result produced by 
the subtraction of two unpacked BCD numbers. AAS sets the high order nibble of 
AL to zero and subtracts 6 from AL and 1 from AH if the value in AL is greater than 9 
or if the auxiliary flag is set. AF and CF are then set, and the high order nibble of AL 
is cleared. If the result in AL is 9 or less, AAS clears the high order nibble of AF and 
updates the flags only: 

MOV ^^L, 0dH ;Use 0000 1000 

SUB PL,03H ;subtract 9 from 8 (should yield a -1) 

ftAS ;Adjust for BCD.* 


What has occurred at the bit level is: 

SUB nL,09H 

0000 1000 -ce = «L.> 

- 0000 1001 <9> 


~i 


nil nil 
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Don’t forget how subtraction is carried out. The two’s complement is performed 
first on the subtrahend, and then the two’s complement of the subtrahend is added 
to the minuend: 

0000 1000 {B> 

+ 1111 0111 <£’s cofnpl«meir»t of 9> 


1111 1111 -1 


AAS sets the high order nibble to zero and subtracts 6 from the result, since the 
value contained in the low order nibble of AL is greater than 9: 

nns 


mm nil 
•h nil 1010 


0FH 

-6 


nil 1001 <ten’s complement of ~1> 

Setting the high order nibble to zero yields: 

0000 1001 in OL, 


AF and CF are set indicating that the value contained in AL is the ten’s complement 
of the correct answer, -1. Your program has to account for the possibility of a 
BCD digit appearing in ten’s complement form after adjustment. Adjustments are 
carried out on BCD digits without regard to sign. In other words, by testing CF and 
AF, you can determine whether the number in AL is true BCD or a ten’s comple¬ 
ment BCD value. 


DAS 


Format: DAS 


Decimal Adjust for Subtraction corrects the accumulator (AL) after subtracting two 
packed BCD digits. DAS checks the lower nibble of AL for a value which exceeds 9. 
If AL is greater than 9 or if the previous subtraction set the auxiliary carry flag (AF), 
6 is subtracted from AL and AF is set. Next, the high order nibble of AL is checked 
for a value greater than 9. If the most significant 4 bits of AL are found to contain a 
value greater than 9 or CF is set, 60H is subtracted from AL and CF is set. 
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Just as DAA adjusts AL after the addition of two packed BCD digits, DAS corrects AL 
to produce a pair of valid packed BCD digits. 


DEC 


Format: DEC destination 


The decrement instruction subtracts 1 from the destination operand. The operand 
may he a byte or word, or register or memory operand. DEC updates AF, OF, PF, 
SF, and ZF. It does not affect CF. If you need to detect a carry condition due to the 
subtraction, use the SUB instruction to update the carry after execution. 


Examples of DEC: 


DEC 

BX 

;Decrement 

word 

in 

register BX 

DEC 

PL 

;Decrement 

byte 

in 

register Pl. 

DEC 

WORD_VPLCSI3 

;Decrement 

word 

in 

memory 

DEC 

BYTE.VPLCSI3 

;Decrement 

byte 

in 

memory 

NEG- 






Format: NEG destination 


The negate instruction forms the two’s complement of the destination operand by 
subtracting it from zero. If the destination operand is a byte equal to -128 (80H) or 
a word equal to - 32,768 (8000H), NEG sets OF without altering the operand. If 
the operand is zero, the sign of the operand is not changed and the zero flag (ZF) is 
set. The other flags affected are CF and SF. 


Examples of NEG: 

NEG OL 
NEG AX 
NEG WORD_VAL 
NEG BYTE_VfiL 


;perform £’s complement on the contents of ftL 
5 perform 2’s complement on the contents of «X 
5 Perform 2’s complement on word in memory 
jPerform 2’s complement on the byte in memory 


CMP 


Format: CMP destination,source 

The CoMPare instruction subtracts the source from the destination. Unlike the SUB 
instruction, which places the result in the destination operand, CMP returns no 
result. You might wonder about the value of an instruction that performs an 
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arithmetic operation, yet does not return a result. Casual observation may lead you 
to believe the instruction is of little value. However, the status flags are updated 
just as if a SUB instruction were executed. This allows the testing of an operand for 
a given value without altering the operand. 

The CMP instruction is followed by a conditional jump instruction to pass control 
to another part of the program, based on the results obtained from the comparison. 
In a moment I’ll discuss the conditional jump instructions, which are used in a 
program to make decisions of this type. 


Examples of CMP: 


MOV 

PL,60H 

•Move 1£0 into PL 

CMP 

PL,DL 

;Compare PL to DL 

JC 

THERE.PR06 

5 If PL <DL> Jump to the portion 

;of the program labeled TH£R£_PR0G 

JZ 

HERE^PROB 

5 If PL * DL then jump to HERE^PROB 

;Otherwise PL is greater than Dt- 


More examples of CMP: 

;Compare BL to £ and set flags 
;Compare register to memory 
;Compare memory to 15 


CMP 

BL,02H 

CMP 

DX,WORD^VPL 

CMP 

BYTE^VPL, 0FH 


Multiplication 

Instructions 


There are three instructions designed to carry out multiplication on the 8088. Two 
of these instructions accommodate either signed or unsigned multiplication; IMUL 
is used when signed multiplication of two operands is to take place, and MUL is 
used to multiply two unsigned operands. In either case, the multiplicand must be in 
the accumulator (AL for byte x byte multiplication, and AX for word x word 
multiplication). 

The source operand can be either a byte or a word. If the operand is a byte operand, 
it is multiplied by register AL. Since byte multiplication can result in word length 
results, the result is placed in the AX register. AH will contain the high order byte of 
the result, and AL will contain the low order byte of the result. 

Similarly, a word multiplication can result in a 32-bit (double word) result. In this 
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instance, the high order word of the result is placed in DX, and the resultant low 
order word Is placed in AX. Figure 4-3 illustrates register usage for the multiplica¬ 
tion instructions. 


Format: MUL source-operand 
IMUL source-operand 

8 Bit Multiplies: AL = Multiplicand 
Source Operand = Multiplier 
Product Returned to AX 

AL = Low Order 8 bits and AH = High Order 8 bits. 

For the MUL instruction, it OF and OF are set, then AH contains a 
non-zero result. 

For the IMUL instruction, if OF and OF are set then AH is NOT the 
sign extension of the low order half of the result. 

16 Bit Multiplies: AX = 16 bit Multiplicand 
Source Opierand = 16 bit Multiplier 
Product Returned to DX:AX 
AX = Low Order 16 bits and DX = High Order 16 bits. 

For the MUL instruction, if OF and OF are set then DX contains a 
non-zero result. 

For the IMUL instruction, if OF and OF are set then DX does NOT 
contain a sign extension of the low order half of the result. 

Figure 4-3 Register Usage for Multiply Instructions (MUL, IMUL) 


MUL 


Format: MUL source 


MUL is used to multiply two unsigned byte or word operands. MUL sets CF and OF 
when the high order half (AH for byte multiplication and DX for word multiplica¬ 
tion) of the result is nonzero. In other words, the multiplication produced a result 
larger than 8 bits. If CF and OF are cleared, the high order half of the result is zero. 
You cannot use an immediate value as the source. AF, PF, SF, and ZF are undefined 
following a MUL operation. 

Examples of MUL: 


MUL 

BX 


MUL 

CL 


MUL 

UlORD. 

.VAL 

MUL 

BYTE, 

.VAL 


;Multiply RX 
^Multiply AL 
;Multiply AX 
;Multiply AL 


by BXg result 
by CL, result 
by memory word 
by memory byte 


in DX:AX 
in AH:AL 

, result in DX:AX 
, result 


in AH:AL 
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IMUL 


Format: IMUL source 


The Integer Multiply instruction is used to multiply two signed byte or word 
operands. The destination operand is the accumulator, AL or AX. Like the MUL 
instruction, the result is returned to either AH and AL for byte multiplication or DX 
and AX if the operands are word values. 

CF and OF are set following the IMUL instruction if the most significant half of the 
result is not a sign extension of the lower half of the result. This indicates that the 
multiplication produced a result in excess of 8 bits for byte-wide multiplication or 
in excess of 16 bits for word-wide multiplication, and that AX or DX contain the 
high order half of the result. 

What Arc Sign Extensions? — 

When multiplication is carried out, byte-wide multiplications can produce a signed 
l6-bit (word) result. Similarly, a word-wide multiplication can produce a signed 
32-bit, or double word, result. The sign of the result is extended to the high order 
half of the result (AH br DX) when the product can be contained within the low 
order half of the result register(s). In other words, when the multiplication pro¬ 
duces a product in the range of —12 8 to -1-127, or — 32,768 to -I- 32 , 767 , the sign bit 
is extended to the high order half of the result. 


For example: 


High Order Byte <ftH) 


Low Order 

Byte 

(HL) 


1111 1111 

<< - 

1000 

0000 

(~1£7> 


1111 1111 

< <- 

nil 

nil 

(-1) 



0000 0000 

< <- 

0000 

0001 

( + 1) 



0000 0000 

<<- 

0111 

nil 

(+128) 


High Order Word (DX) 


Low Order 

Word 

(HX) 


1111 1111 1111 1111 

<<- 

1000 

0000 

0000 

0000 

(-32,768) 

1111 1111 nil nil 

< <- 

nil 

nil 

nil 

nil 

(-1) 

0000 0000 0000 0000 

<<- 

0000 

0000 

0000 

0001 

( + 1) 

0000 0000 0000 0000 

< <- 

0111 

nil 

nil 

nil 

(+32,767) 


In each instance, the sign bit of the low order half is copied into each bit of the high 
order byte, thereby preserving the true value of the result. 

By extending the sign of an operand, different data types may be used in signed 
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multiplication, addition, and division operations. The 8088 instructions CBW 
(convert byte to word) and CWD (convert word to double word) perform sign 
extensions on the accumulator. CBW copies the sign bit (b7) of AL into each bit 
position of AH. CWD copies the sign bit (bl5) of AX into each bit position of the DX 
register. 

I’ll discuss how the CWD is used in division in a moment, but for now consider the 
following examples: 

Example 1. 

Add the byte value of 16H to the word value in CX: 

MOV AL,16H ;Place the value into AL 

5 AL* 0001 0110 and AH = ???? ???? 

CBW ;AH « 0000 0000 

;AL » 0001 0110 

ADD CX,AX ;Add AX to CX 

Example 2. 

Multiply the byte value in AL by the word stored in memory at the location 
WORD_VAL: 

MOV ttL,B0H ;Movb -1£8 into ftL 

CBW ;nH = 1111 1111 and Au 1008 eOBO 

IMUL W0RD_VAL ;Multiply by mamory operand, result is 

;in OX IAX 

Example 3. 

Subtract a word in memory from the byte value in register BL: 


XCH6 

AL,BL 

;Get value into Al in order to perform 



;sign extension. 

CBW 


;Extend sign 

XCH6 

AX,BX 

;swap registers, restore Bu, and place 



;extension in BH. 

SUB 

BX, W0RD_VAL 

;A word has now been subtracted from 


;what was a byte value. 
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AAM 


Format: AAM 


The instruction AAM (ASCII Adjust for Multiplication), corrects the result of a 
previous multiplication of two valid unpacked BCD digits. In order for AAM to 
work correctly, the high order nibbles of the operands multiplied must have been 
set to zero prior to executing the multiplication instruction. AAM returns two valid 
unpacked BCD digits to AH and AL. 

AAM performs the correction by first dividing AL by 10. The quotient is placed in 
the AH register, and the remainder is placed into the AL register. AAM affects PF, 
SF, and ZF. AF, CF, and OF are undefined following the execution of the AAM 
instruction. 


Division 


Three instructions are used for division. 


DIV- 

I Format: DIV source | 

The DIV instruction is used when performing an unsigned division of the 
accumulator by the source operand. If the source operand is a byte value, it is 
divided into the l6-bit value (word) contained in AH and AL. The quotient is 
returned to AL, and the remainder is placed in AH. 

Similarly, if the source operand is a word value, it is divided into the 32-bit (double 
word) value contained in DX and AX. The quotient is placed in AX, and the 
remainder is returned to DX. The source operand cannot be an immediate value 
(constant). 

Division by Zero — 

As I discussed previously one of tbe interrupt vectors (type zero) is used for an error 
condition, division by zero. Since division by zero is undefined, the 8088 generates 
a type zero interrupt. To avoid this condition, you should test the source operand 
prior to executing the DIV or IDIV instructions. You could also replace the vector 
used for the type 0 interrupt with one containing the address of your own error 
routine. 

The type zero interrupt is executed anytime the capacity of the destination register 
is exceeded by the quotient. For unsigned divisions using the DIV instruction, this 
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condition exists when the quotient exceeds OFFH (256) for byte source operands 
and OFFFFH (65,535) for word operands. 

When these values are applied to signed operands using the IDIV instruction, they 
become quotients where maximum and minimum values are exceeded. A type zero 
interrupt is executed when byte operands exceed 7FH ( + 127) and 80H (-128). A 
type zero interrupt is also executed when word size source operands exceed 
7FFFH (+ 32,767) and 8000H (- 32,768). 

When the type zero interrupt occurs, the quotient and remainder are left in an 
undefined state. The DIV instruction leaves AF, CF, OF, PF, SF, and ZF in an 
undefined state after execution. 


Some 

examples of DIV are: 




DIV 

BL 

;Divide 

PX by BL, quotient to ftL, remainder to 

AH 

DIV 

CX 

^Divide 

DX:^^X by CX, quotient to PX, 

remainder 

to 



5DX 




DIV 

BYT£_VAL 

;Divide 

by byte wide memory operand. 



DIV 

WORD^VftL 

;Divide 

DX:AX by the contents of the 

word wide 




;memory 

operand WORD^VftL. 



MOV 

CL,10H 

;Divide 

by a constant (16 decimal). 



DIV 

CL 

;Divide 

AH:AL by the contents of CL 

( = 16) 


IDIV- 






Format: IDIV source 


The Integer Divide instruction performs division on the signed source operand 
and a signed value in either AH and AL (source = byte) or DX and AX when the 
source operand is a byte value. 

As in the DIV instruction, a type zero interrupt is executed anytime the maximum 
or minimum capacity of the destination operand is exceeded by the quotient (see 
the above discussion of division by zero). This can occur when the source operand 
is zero. 

Some examples of IDIV are: 

IDIV CL ;Divide ftH:fiL by CL. Quotient in fiL and nemainden 

;in RH 

IDIV CX ;Divide DX:RX by CX. Quotient in AX and nemainder' 
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tin DX. 


IDIV 

BYTE_VAlCSI3 

;Divide AH:AL by byte value at memory 

;BYTE_VAL + the offset in SI. 

MOV 

BL,10H 

;divide AH:AL by 16 

IDIV 

BL 



I mentioned that the CWD (Convert Word to Double word) instruction can be used 
to sign extend (copy) a word value to a double word value. The sign bit, bit 15, of 
the word in AX is sign extended into all bit positions in the DX register. By using 
CWD and IDIV, you can divide two-word values. 

IDIV expects to find a 32-bit dividend in DX and AX. You cannot simply move a 
signed value into the AX register and then divide by some other value. DX must 
contain either the high order 16 bits of the dividend or a sign extension of the l6-bit 
dividend contained in AX. 

Some examples of sign extension division are: 


MOV 

AX,W0RD_VAL1 

;Move 16 bit value into 

AX 


CWD 


;Sign extend AX to DX 



IDIV 

W0RD_VAL2 

;Divide by the contents 

of 

memory 



;1ocation WORD_VAL£ 



MOV 

AL,BYTE^VALl 

;Get dividend 



CBW 


;Sign extend to AH 



IDIV 

A JkT% 

BYTE_VAL2 

;Divide by the contents 

of 

memory 







Format: AAD 


The ASCII Adjust for Division corrects the dividend in AL prior to dividing two 
unpacked BCD numbers. Essentially, the instruction multiplies the AH register by 
10 and adds this value to the low order register AL. In effect, the packed value is 
converted to binary. AH is then zeroed: 

MOV AX,0309 ;ln unpacked BCD this value represents 

;39 decimal. 

AAD ;Value in AX is now- AH = 0000 0000 

; and AL. =: 0010 0111 
;divide by the contents of CL. 


IDIV 


CL 
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AAD updates PF, SF, and ZF. All other flags are undefined after executing the AAD 
instruction. 



If you decided to read this chapter straight through, I suggest that you now take a 
break, go get a cup of coffee (etc.), and, by the time you get back. I’ll be ready to talk 
about logic instructions. We have much more to discuss in this chapter, so take a 
break; you deserve one. 



Logic Instructions 


The logic instructions apply Boolean logic to each bit position of the source 
operand and to the corresponding bit positions of the destination operand. 
Whether you know it or not, the rules of logic abound in everyday life. Let’s take a 
look at some everyday events and relate this logic to the logical instructions AND, 
OR, XOR, TEST, and NOT. 

AND- 

I Format: AND destination,source 


A logical AND function is one which states that two events must be true in order for 
the result of the operation to be true. Table 4-2 contains the truth table for the AND 
function. 

If I want to turn my IBM PC on, I must have the power cord plugged into an active 
AC outlet AND I must turn the power switch on. If either of the input conditions is 
not satisfied, power is not delivered to the internal power supply of the IBM PC. An 
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Table 4-2 

Truth Table For Logic Operations 

AND & TEST 


Operands 

Result 

Example: AND AL, BL ;AL=07EH 

A B 

c 

:BL=023H 



— AL = 0111 1110 

0 0 

0 

BL = 00100011 

0 1 

0 


1 0 

0 

Result in AL = 0010 0010 (After AND only) 

1 1 

1 

‘TEST does not return the result to the 
‘destination operand. 

OR 

Operands 

Result 

Example: OR BL, CL ;BL=34H 

A B 

c 

:CL=E7H 

0 0 

0 

~ CL = 11100111 

0 1 

1 

BL = 0011 0100 

1 0 

1 


1 1 

1 

Result in BL = 1111 0111 = 0F7H 

XOR 

Operands 

Result 

Examples: XOR AH,34H ;Find bits different 

A B 

C 




— AH = 1101 0011 

0 0 

0 

0011 0100 

0 1 

1 


1 0 

1 

Result in AH = 11100111 = E7H = AH 

0 0 

0 

Clear AX: XOR AX, AX 

AX = 1010001111110101 

1010001111110101 


Result in AX - > 0000 0000 0000 0000 

NOT 

Operand 

Result 

Example: NOT AX 

A 

B 

AX = 1101 0011 1101 0111 

1 

0 

NOT--> 00101100 00101000 

0 

1 

(Result in AX) 


equation of this function can be written as: 

(Active AC power outlet) AND (Power switch in the ON position) = IBM PC in the 
ON condition. 

When using the AND instruction in a source program, you are performing a logical 
AND of either a byte or word source operand with that of the destination. Each bit 
in the source is ANDed with the corresponding bit of the destination. Bit 1 is ANDed 
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with Bit 1, b2 with b2, etc. The result of the operation is placed in the destination 
operand. 

For example, AND AL,72H functions in the following manner: 

07 b& bS b4 b3 b2 bl bO 

fll_« 0F0ri ftND 72H =1 1 1 10000 <Binary) 

RNO 01110010 (Binary) 

R«»ult is in ftL = 0 1 1 1 0 0 0 0 (Binary) = 70H 

Notice that bit? is reset in the result. When b7 of the destination (AL), which 
contains a 1, is ANDed with the zero contained in b7 of the source, 57 of the result is 
zero due to the rules of logic illustrated in Table 4-2. Similarly, bl is also reset in the 
result. 

Some examples of the AND instruction are: 


AND 

AL, BL 

;AND the contents of AL with BL and 



;plac& the result in Al. 

AND 

BX, DX 

;AND two IG bit registers. 

AND 

word^val, ax 

5 AND a register and memory, place result 



;in memory. 

AND 

Al,BYTE^VAL 

;AND the contents of memory with Al and 



;place the result in AL. 

AND 

AL,11111000B 

5 AND AL with a constant 


AND updates CF, OF, PF, SF, and ZF. AF is undefined following the AND instruc¬ 
tion. 

You can use the AND instruction to mask bit position. A mask is a predefined bit 
pattern used to set or reset certain bit positions. In the example above, AL was 
ANDed with the binary pattern 11111000. This has the effect of clearing bits 0-2 in 
the destination operand (AL), while leaving the other bit positions in whatever 
state they were in prior to the execution of the AND instruction. 
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OR--- 

Format: OR destination,source 


The OR instruction sets a bit in the result, provided that the corresponding bit in 
either the destination OR the source operand is set to a binary 1. It is a little like 
saying I’ll wake up in the morning if my alarm clock goes off OR if someone wakes 
me; otherwise, Til sleep until noon. If either situation is satisfied, independently or 
simultaneously, I will awaken. Table 4-2 contains the truth table for a two-input 
OR function. 

Some examples of the OR function are: 

OR AL, 11110000B ;OR Al. with a constant* This technique 

;can be used to set specific bits in the 
-destination operand while leaving all 
;others in their previous state. Here 
;bits 4~7 are set to a ’1’ 


OR 

BYTE^VHL,HL 

;OR 

memory i 

with 

contents of 

AL 

OR 

AX,BX 

;OR 

RX 

with 

the 

contents of 

BX. 

OR 

BX, WORD^VPL 

;OR 

BX 

with 

word 

1 in memory. 



The OR instruction updates CF, OF, PF, SF, and ZF. AF is undefined after execution 
of the OR instruction. 

The primary use of the OR instruction is to set specified bits in the destination 
operand. However, the OR instruction can be used to determine if a register 
contains zero. For example, OR AX,AX sets the status flags but does not alter any 
bits of the AX register, since a bit ORed with itself remains unchanged (A OR A = 
A). If AX is zero, the Z flag is set after the instruction OR AX, AX. You can use this 
information to effect a conditional jump (JZ, jump on zero) to another part of the 
program. 


XOR--__— 

I Format: XOR destination, source 


The exclusive OR instruction sets a bit in the result if the corresponding bit in the 
source and destination operands are of opposite values (one set to 1, and one reset 
to 0). In other words, if one and only one bit for a given bit position in either the 
source or destination operand is true (1), then the corresponding bit position of the 
result will also be true. This is known as mutual exclusion. The truth table for the 
XOR function is given in Table 4-2. 
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The XOR instruction can be used to determine which bits are not the same in a 
source and destination operand. Bits that differ between the source and destina¬ 
tion operand are set in the result following the XOR. The XOR instruction can also 
be used to clear a register to zero. 

For example, XOR AX,AX zeros the AX register. Since the bits in both the destina¬ 
tion and the source are the same (it’s the same register), the resultant bits are all 
zero. XOR updates CF, OF, PF, SF, and ZF. AF is undefined after the execution of 
the XOR instruction. 


Some examples of the XOR instruction are: 


XOR 

AL, AL 

;Set AL to zero 


XOR 

AL,11000000B 

;If bits 7 or 6 are set 

in Al., flip them to 



;zero. 


XOR 

BX, AX 

;Set the bits which are 
;operands. 

different in original 


TEST - 

I Format: TEST destiiiation,source 


The TRS’r instruction performs a logical AND on the destination and source 
operands. Unlike the AND instruction, which returns the result of the operation to 
the destination operand, the TEST instruction does not return a result. It does, 
however, update CF, OF, PF, SF, and ZF. AF is undefined after the TEST instruction 
has been executed. 

Some examples of the TEST instruction are: 


TEST AL,0000111IB 

JN2 THERE 

TEST DX,BX 

PORT^PftJft, ftX 


;Test thi? Al register, bits 0-3 for 
Sa logical 1. 

;If any bits are set jump to 
^another part of the program. 

IAND the contents of the ^ord wide 
^registers DX and BX and set flags. 
;AND memory and AX, and set flags 


TEST 
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NOT 


Format: NOT destination 


The NOT instruction performs the one’s complement on the destination operand. 
Each hit in the destination operand is reversed. No flags are affected by the NOT 
instruction. 

Some examples of the NOT instruction are: 


NOT 

PL 

;Flip bits in Pl 

NOT 

WORD^VPL 

5 Perform I’s complement on the word stored 



;memory. 

NOT 

BYTE^VPL 

;Perform I’s complement on memory operand. 

NOT 

DX 

;Invert the bits in DX. 

NOT 

ME ;Complement 

memory. (I couldn’t resit this 


; one!). 


Shift Instructions 


The shift and rotate instructions are used to isolate individual bits within a byte or a 
word. Each affects the carry flag as shown in Figure 4-4. These instructions can also 
be used to multiply or divide an operand by a power of two. For example, if the 
value contained in AL is 8, shifting AL left one bit position has the effect of 
multiplying AL by 2. This can be illustrated as: 

decimal = 0000 1000 

Multiply by SftL ftL., 1 then PL = 0001 0000 = 16 decimal. 

Divide by 2 : SPR PL,1 then PL = 0000 1000 = 8 decimal. 


Shift instructions shift a bit out of the destination operand and into the carry. 
Unlike the shift instructions where the MSB or LSB is shifted into the carry, the 
rotate instructions recirculate the bit back into the destination operand. In this 
manner, the bit is preserved. 

SAR- 


Format: SAR destination, count 


As shown in Figure 4-4, Shift Arithmetic Right (SAR) and Shift Arithmetic Left (SAL) 
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SHL and SAL 

Shift Logical Left. Shift Arithmetic Left 
CF Bx.BO 


SAR 

Shift Arithmetic Right 
Bx.BO 


SHR 

Shift Logical Right 
Bx.BO CF 


ROL 

Rotate Left 

CF Bx.BO 


ROR 

Rotate Right 


Rotate through Carry Left 
Bx. 


RCR 

Rotate through Carry Right 


Figure 4-4 Illustration of how each bit position is shifted, or rotated the specified number of times. In 
the illustrations, Bx is the MSB of the operand. For byte values Bx would be B7and for word 
values, Bx would be B15. Note how the carry is used in each instruction. 
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are used to shift the contents of an operand right or left 1 or more bit positions. The 
arithmetic shifts move the operand by a specified number of bit positions. If you 
want to shift only one bit position to the right, the count can be specified by SAR 
AL,1. However if the count is greater than one, register CL must be used to specify 
the total number of bits to be shifted as in: 

MOV CL, 3 ;Shift 3 bits 

SAR BL,CL ;Shift BL three times 

SAR shifts the low order bit into the carry, and the high order sign bit remains 
unchanged (b7 for byte operands and bl5 for word operands). The original sign bit 
is shifted in from the left, which causes the sign bit to remain unchanged. 

Be careful when you use the SAR instruction to divide a negative number by a 
power of two. SAR may not produce the anticipated result. See Appendix B and the 
SAR description to find out why. 

SAL and SHL- 


Format: SAL destination,couiit 
SHL destination,count 


Shift Arithmetic Left (SAL) and Shift Logical Left (SHL) shift the destination operand 
left by a specified number of bits, as shown in Figure 4-4. These instructions are 
identical in operation. Both shift zero bits into the destination operand from the 
right, and the bit shifted out of the MSB of the operand is transferred to the carry. 
The overflow flag is set if a bit shift count of one produces a result whose sign 
differs from the original operand. 

For example, if AL contains 1000 OOOIB, then: 

SHL HL,1 

produces 0000 OOlOB in AL. The binary 1 shifted out of the operand (b?) is 
contained in the carry. Since b7, the sign bit, did not retain its original value, OF is 
set. The overflow flag is not defined for bit shifts of a count other than 1. PF, SF, and 
ZF are also affected by SHL and SAL, while AF is undefined. 

SHR-- 

Format: SHR destination,count 


The Logical Shift Right instruction (see Figure 4-4) is used to shift the bits in the 
destination operand right a specified number of bit positions. As in the case of the 
other shift instructions, a count of 1 can be coded directly into the instruction. For 
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variable shift counts, the contents of the CL register define the shift count. Zeros 
are shifted into the MSB of the destination operand, while the LSB (bO) is shifted 
into the carry flag. 

Some examples of the SHR instruction are: 


SHR 

HL, 1 

;Shift PL right 1 bit. 

SHR 

BX,CL 

;Shift BX right by the number of bits 



;specified in CL. 

SHR 

HORD_VHL C S13 C BX1,CL 

;Shift the contents of the memory 


;located at WORD_VAL plus the 
joffset of SI and BX, right by the 
;number of bits specified by CL. 


Rotate Instructions 


The rotate instructions ROL, ROR, RCL, and RCR are used to rotate bits in a circular 
fashion from left to right or right to left. Figure 4-4 illustrates the manner in which 
the bits in an operand are rotated for each instruction. 

Unlike the shift instructions, which shift bits into and out of the operand, rotate 
instructions actually circulate a bit from one side of the operand to the other. RCL 
and RCR involve the carry in the rotation of bits, whereas ROR and ROL copy the 
MSB or LSB into the carry. Assume that BL contains 0001 OOllB and the carry bit is 
set. After executing the instruction: 

RCL BL,1 


BL contains 0010 OlllB, and the carry flag contains zero, the value shifted out of b7 
from the operand. 

ROR, ROL- 

Format: ROR destination,count 
ROL destination,count 


Rotate Right (ROR) is used to shift the destination operand a specified number of 
bit positions to the right. ROL is used to shift the contents of the operand to the left 
by a specified number of bit positions. ROR shifts the LSB (bO) of the operand into 
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the MSB (b7 for byte operands and bl5 for word operands). The LSB is also copied 
into the carry flag. 

Similarly, ROL shifts the MSB of the operand into the LSB of the operand, while 
placing a copy of the MSB in the carry flag. OF is set if the count specified is equal to 
1 and the sign bit (MSB) of the operand changes value. 

RCL and RCR . 


Format: RCL destination,count 
RCR destination,count 


Rotate through Carry Right (RCR) rotates the destination operand right a specified 
number of bit positions. (See Figure 4-4.) CF is rotated into the MSB of the operand, 
while the LSB becomes the new value of the carry flag. 

Rotate through Carry Left (RCL) rotates the destination operand to the left a 
specified number of bit positions. The carry flag is rotated into the LSB, while the 
previous contents of the carry are rotated into the MSB of the operand. 

Assume AL contains 0111 lOlOB = 7AH, the carry flag is initially reset, and CL 
contains 3. The following illustrates the RCR instruction: 





c 

b7 

b6 

bS 

b4 

b3 

bS 

bl 

b0 



Original 

Value 

in AL 

0 

0 

1 

1 

1 

1 

0 

1 

0 



RCR 

AL, CL 

i 

0 

0 

0 

1 

1 

1 

1 

0 

1 

(1st 

rotate) 



; 

1 

0 

0 

0 

1 

1 

1 

1 

0 

(Bnd 

rotate) 



; 

0 

1 

0 

0 

0 

1 

1 

1 

1 

<3rd 

rotate) 


The instruction rotates the AL register to the right 3 bit positions. The final value in 
AL is 8FH and the carry flag is reset. 

Other examples of the rotate instructions are: 


ROR BX, CL 
RCL AL, 1 

ROL WORD_VALCS13,CL 


;Rotate BX the number times specified in CL 
$ Rotate AL left one time. Include the carry |bit. 

9 Rotate the contents of memory, CL number of times. 
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Control and transfer instructions allow branching to another part of the program; 
program execution control is transferred to a new portion of memory. Intel 
divides the control transfer group into four distinct categories: 

1. Unconditional transfers; 

2. Conditional transfers; 

3. Iteration control; and 

4. Interrupts. 

Control may be passed to a portion of memory in the current segment, or control 
may be passed to a new code segment. 


Unconditional Transfers 


Unconditional transfers do not require a condition to meet prior to transferring 
control to another portion of the program. It’s a little like the drill sergeant in the 
army who screams “JUMP!” and you ask “How high?” The only difference is that 
the 8088 needs to know “How Far?” 


CALL and RET —-- 

Format: CALL procedure 

_ RET optional POP value __ 

The CALL instruction enables a program to invoke a procedure (also known as a 
subroutine). A procedure is a frequently used portion of code. When the instruc¬ 
tions required to execute a certain function are incorporated into a procedure and 
not placed into the main program every time the procedure is needed, there is an 
overall reduction in the amount of code generated. 

The procedure is called as required. Calls can be made to procedures within the 
same code segment (intrasegment) or to procedures in a different code segment 
(intersegment). When the 8088 encounters an intrasegment CALL instruction, the 
contents of the instruction pointer are pushed onto the stack, and the instruction 
pointer is loaded with the offset address of the procedure. Program execution then 
continues with the first instruction contained in the procedure. 
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The RET (RETurn) instruction is used to exit the procedure and return to the calling 
program at the instruction immediately following the CALL instruction. When the 
8088 encounters the intrasegment RET instruction, the l6-bit offset which was 
saved on the stack is popped into the instruction pointer. This causes program 
execution to resume at the instruction following the original CALL instruction. 

An intersegment CALL invokes a procedure contained in a code segment other than 
the one currently in use. An intersegment CALL first pushes the current contents of 
the code segment register onto the stack, followed by the contents of the instruc¬ 
tion pointer. The segment address of the procedure is then placed into the CS 
register, and the procedure’s offset within the segment is placed into the IP 
register. 

When an intersegment RET is encountered within the procedure, the offset value 
previously pushed onto the stack is placed in the instruction pointer, and the CS 
register is restored with its previous value, which was also saved on the stack. 
Program execution resumes with the instruction following the original CALL 
instruction. 

Figure 4-5 illustrates how an intrasegment procedure is written and how the 
procedure is called from another portion of the program. Notice that the pro¬ 
cedure is defined as NEAR. This assembler pseudo-op instructs the assembler to 
generate intrasegment CALL and RET instructions. If the procedure had been 
defined as FAR, intersegment CALLS and RETs would have been generated. When 
an intrasegment CALL is executed, only the instruction pointer is saved on the 
stack. When an intrasegment RET is executed, the IP register is restored, and 
program execution resumes with the instruction following the CALL to the pro¬ 
cedure. 


MAIN.PROC PROC FAR 

: Main program code 


CALL WHATS_MY_LINE ; Call the procedure: Defined in 
; this segment. Only IP is saved! 

MAIN_PROC ENDP 
WHATS_MY_LINE PROC NEAR 

; Procedure Code 


RET ; IP is restored by this instruction. 

WHATS_MY_LINE ENDP 


Figure 4-5 Intrasegment Procedure Example 
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Remember the difference: Intrasegment CALLs and RETs save and restore only the 
offset IP, while intersegment CALLs and RETs save and restore both the CS register 
and the IP register. You can directly specify the procedure’s address within the 
instruction as in CALL THAT_PROCEDURE. THAT_PROCEDURE may be of either 
a NEAR or FAR type. 

Additionally, you may want to place a procedure’s address in memory and indi¬ 
rectly call the procedure by using one of the general purpose registers. To do this, 
the register is loaded with the address of the memory location containing the 
address of the procedure to be called. 

For example, assume the memory location KEY_BRD holds the address for a 
keyboard scan routine. The routine scans the keyboard and determines if there is a 
key closure. The following instructions can be used to indirectly call the procedure 
through the BX register: 

LEft BX,KEY_BRD ;ftddress of KEY#BRD memory location. 

CALL BX ;Use the address stored at KEY_BRD as 

5 the procedure’s start address. 


It is often necessary to pass a value (or two, or more) to a procedure. The 
parameters may be required to perform some type of calculation or to access data 
(i.e., they may be an address parameter). In either case, the parameters can be 
pushed onto the stack prior to calling the procedure. Once in the procedure, the BP 
register is used with the stack pointer (SP) to address the variables. 

When the procedure is finished, an optional constant can be specified in the RET 
instruction. The constant is added to stack pointer. Remember our rule about 
dealing with the stack: For every PUSH there is a POP, and for every POP there 
must be a PUSH. The parameters that were passed to the subroutine must be 
discarded. The optional constant operand effectively pops the parameters from 
the stack, thereby restoring the stack pointer. 


JMP- 

I Format: JMP target 


The Jump instruction transfers control to another portion of code. The transfer 
location may be in the same segment (intrasegment) or in another segment (inter¬ 
segment). JMP does not save information on the stack, as the CALL instruction 
does. Like the CALL instruction, the JMP instruction can be either a JMP direct or a 
JMP indirect. You can also use the assembler pseudo-op SHORT to specify that the 
target operand is within +127 to -128 bytes of the JMP instruction. The assembler 
automatically generates a 2-byte SHORT JMP if the target is within the allowable 
range. If the assembler cannot make this determination or if you do not explicitly 
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use the SHORT operator, the assembler generates a 3-byte NEAR JMP instruction. 
NEAR JMPs allow the target to be within + 52,767 to - 32,768 bytes from the JMP 
instruction. 

Some examples of the JMP instruction are: 


JMP 

CX 

;Jump indirect using CX 

JMP 

THIS.SE6MENT 

9 Jump NEAR 

JMP 

SHORT THIS^SESMENT 

9 THIS_SEBMENT is within -^127 or -128 
9 bytes of this instruction. 

JMP 

FftR PTR THPT.SEQMENT 

9 Jump to another segment. 


Intersegment jumps produce five bytes of code. One byte signifies that the JMP is an 
intersegment JMP, two bytes specify the code segment, and two bytes specify the 
segment offset of the target operand. JMP does not affect the flags. 

Conditional Transfer 
Instructions 


Certain instructions set or clear the status register’s flag bits. Conditional transfer 
instructions transfer control to another part of the program if the specified condi¬ 
tion is met. It’s a little like saying I will meet you for lunch IF you are free today at 
noon AND you are buying. If the conditions are met, I will be somewhere I would 
not otherwise be—having lunch with you. 

Conditional transfer instructions behave in a similar manner. If a condition is met, 
the 8088 begins execution at a new address. If the condition is not met, the 8088 
executes the next instruction, the one following the conditional jump instruction. 
This decision-making capability is why the microprocessor is so important in real¬ 
time applications. Since the microprocessor is capable of executing hundreds of 
thousands of instructions per second, decisions are made in microseconds. 

The 8088 allows many different types of conditional transfer instructions (see 
Table 4-3). Included in this instruction group are instructions which will jump to 
another part of program memory if CF, ZF, SF, OF, or PF is set. JZ target transfers 
control to another part of the program (specified by the operand target), if the zero 
flag is set, while JC target transfers control to another part of the program if the 
carry flag is set. 

Also included in the conditional jump instruction set are instructions which trans¬ 
fer control to another part of memory when the status flags are reset. JNC target 
causes program execution to begin at the specified portion of memory if the carry 
flag is clear (CF = 0). JNZ target transfers control to the target operand if ZF = 0. 
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Table 4-3 

Conditional Transfer Instructions 
Jump if_ 

Flag Condition 

JA/JNBE 

Jump if above/not below 

(CSorZF)=0 

JAE/JNB 

Jump if above or equal/not below 

CF = 0 

JB/JNAE 

Jump if below/not above or equal 

CF=1 

JBE/JNA 

Jump if below or equal/not above 

(CForZF) = 1 

JC 

Jump If carry 

CF=1 

JE/JZ 

Jump if equal/zero 

ZF = 1 

JG/JNLE 

Jump if (< > / not > nor = 

((SFxorOF)orZF)=0 

JGE/JNL 

Jump If greater or = /not < 

(SFxor OF)=0 

JL/JNGE 

Jump if less/not greater nor equal 

(SFxorOF) = 1 

JLE/JNG 

Jump if < or = / not > 

((SFxorOF)orZF) = 1 

JNC 

Jump if not carry 

CF=0 

JNejNZ 

Jump if not equal/not zero 

ZF=0 

JNO 

Jump If not overflow 

OF = 0 

JNP/JPO 

Jump if not parity/parity odd 

PF=0 

JNS 

Jump if not sign 

SF=0 

JO 

Jump if overflow 

OF = 1 

JP/JPE 

Jump if parity/parity even 

PF = 1 

JS 

Jump if sign 

SF = 1 


1 mentioned in a previous example that the carry flag is set when a CMP instruction 
is used and the destination operand contains a value less than the source operand. 
We can state this condition in several ways. We can jump if the carry flag is set (JC), 
if the destination is less than the source (JB), or if the destination is not above 
(greater than) or equal to the source operand QNAE). All three instructions accom¬ 
plish the same function: jump to another portion of code if the carry flag is set. 
Similarly, the instructions JNC Qump on No Carry), JNB (Jump on Not Below) and 
JAE (Jump on not below) all transfer control to another portion of the program if CF 
= 0 . 

The status flags are set or reset as a result of a previous instruction. Some of the 
8088 instructions alter the flags, while others do not. The MOV instruction does 
not affect any of the flags; it simply moves data from one place to another within 
the system. CMP, SUB, ADD, SBB, ADC, and the logical, shift, and rotate instruc¬ 
tions are among those which do alter the flags. 


A Programming Example 

Assume for a moment that you want to go to the part of the program which turns 
your coffee warmer off once the coffee has reached a preset temperature. The 
program flow chart might look something like that of Figure 4-6. In Chapter 2 in 
Figure 2- 5, the diamond-shaped symbol designates a portion of the program where 
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Figure 4-6 


a decision must be made. This is where you would insert one or more of the 
conditional jump instructions from Table 4-3. 

In our coffee warmer program, we’ll make some assumptions about the hardware. 
An analog-to-digital converter (ADC) is attached to the computer at some port 
labeled TEMP_PORT. Another port, CONTROL_PORT, is used to turn the warmer 
on and off. The exact port numbers are not important in our example. 

The ADC is used to convert an analog voltage to a digital byte or word that the 
microprocessor understands. The voltage fed to the ADC is a proportional repre¬ 
sentation of the coffee’s temperature. The binary representation obtained by the 
ADC tracks the voltage and, therefore, the temperature. 

Now all you have to do is to choose the appropriate instructions to turn the warmer 
on, check the temperature, and turn the coffee warmer off if the desired tem¬ 
perature has been reached. Assume that the binary value 0000 HUB is used to turn 
the warmer on and 1111OOOOB turns the warmer off, and that the label HOT defines 
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the binary representation of the temperature the coffee must be at when the 
warmer is turned off. 


TEMPERATURE PROCEDURE NEAR 

OUT CONTROL.PORT,00001111B 
SET.TEMPi IN AL,TEMP_P0RT 
CMP AL,H0T 
JAE TURN.OFF 

JMP SET_TEMP 

TURN_0FFI OUT CONTROL.PORT, 1111OOOOB 
RET 

TEMPERATURE ENDP 


5 Turn warmer on. 

;6et the current temperature 

$Is the value HOT? 

I Jump if the temperature is 
Iabove or equal to the value 
5of HOT. 

;If it is not HOT, then test again. 
ITurn the warmer off. 

I Return to the main program 


This example is typical of how decision-making instructions are used within a 
program. Actually, the procedure above is not a very good program, because there 
is no provision for what to do if the desired temperature is never reached. In other 
words, my program is only looking for the temperature to reach a predetermined 
level; it does not care how long it takes. 

A better approach would be to check a timer and count the elapsed time that the 
warmer has been on. If the temperature is not reached in a specified amount of 
time, the program should terminate and shut off the timer. 

Using RAM for 
Communications 


Another often used technique is to define each bit position in a byte or a word of 
memory, giving each a special meaning. The significance of each bit position is 
used to convey information to another part of the program. RAM locations are 
often used for such purposes and are commonly referred to as semaphores. 

If the bit is set, it means one thing; if the bit is reset, is means another. The sample 
program at the end of Chapter 2 fetched a word from memory that contained the 
system configuration for your computer. Each bit in the word specifies whether a 
resource (such as an RS-232 card or the game port adapter) is in the system. 

By rotating a bit into the carry, a decision can be made as to whether or not the 
resource is available. If the bit is set, the resource is available. If the bit is reset, the 
resource is not in the system. 
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For example, find the label DC2 in Listing 2-1. The status word is moved into the AX 
register, and bO is rotated into the carry. If this bit is reset, there are no disk drives 
in the system. If the bit is set, the program determines the number of available disk 
drives and displays the number on the screen. I used the JNC Oump on No Carry) 
instruction to skip the portion of code to display the number of disk drives in the 
system. The carry is cleared (no carry) if bO in the status word is clear. 

Conditional transfer instructions are very powerful programming tools. Without 
them, the microprocessor would be of little value. 


Iteration Control Instructions 


LOOP, LOOPZ, LOOPNZ- 

At the beginning of this chapter, I made the statement that the 8088 contains 
instructions that allow you to perform a function similar to that of BASIC’s FOR 
and NEXT program statements. FOR and NEXT are used in BASIC to repeatedly 
execute the program statements that appear between the two statements, or within 
the iterative loop they form. The general form of the FOR and NEXT loop is: 


10 FOR I > 10 TO 1 STEP -1 
80 PRINT "MY NPME 18 BftRY" 

30 NEXT 1 

In the programming example above, line 20 will be executed ten times. That is, MY 
NAME IS GARY will be printed on the video display ten times. The iteration count 
is assigned to the variable I and is decremented by 1 each time the NEXT instruction 
is executed. 

In a s imilar manner, a source program for the 8088 can be created that allows a 
series of instructions to be repeated a specified number of times. The LOOP 
instruction is used for this purpose. For example: 


LEA BX,SOME_PART_OF_MEMORY 
MOV CX,10 
HERE.IS MOV BX,0 

INC BX 
INC BX 

LOOP HERE.I8 


9 Put address ^into BX. 

9 Set loop counter to 10. 

9 Store zero at word addressed 
9 by BX. 

9 Point to next word. 

9 INC twice for words. 

9 Loop until. CX « zero. 
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In the programming example above, CX specifies the number of times the loop is to 
be executed. BX points to the start of a portion of memory we wish to clear. The 
program clears a word of memory ten times (20 bytes). Each time through the loop, 
zero is stored at the memory location pointed to the BX register and in the next 
location (BX +1). BX is incremented twice, so that it will point to the next word 
location. The LOOP instruction decrements the counter, CX, by one. If CX does 
not contain zero, the program loops back to the instruction at the label HERE_IS. 

The LOOP instruction can only transfer control to a destination operand within 
-128 to +127 bytes of the LOOP instruction. 

There are three variations of the LOOP instruction: 

1. LOOP, which decrements the CX register by one and transfers control to the 
destination operand if CX does not equal zero, 

2. LOOPZ (or LOOPE), which decrements CX by one and transfers control if 
CX is not zero and the zero flag is set, and 

3. LOOPNZ (or LOOPNE), which decrements CX by one and transfers control if 
CX is not zero and ZF is not set (cleared). 

Another example of the LOOP instruction is: 


MOV CX,0FFFFH 
HERE! IN flL, TEMP_P0RT 
CMP fiL, HOT 
LOOPNE HERE 

OUT CONTROL_PORT,111100008 


|SBt up iteration counter. 

{Input from a port. 

{Is it equal to HOT? 

{If not equal and CX not equal 
{to zero, keep trying. 

{Turn off warmer. 


In this example, the program inputs data from the specified port (TEMP_PORT) up 
to 65,536 times, as designated by the count in CX. If the value obtained from the 
port is equal to the value assigned to the label HOT or if the CX register is zero, the 
loop terminates, and the next instruction (OUT CONTROL_PORT,11110000B) is 
executed. 
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Jump on CX 
Equal to Zero 


JCXZ- — 

I Format: JCXZ target 

JCXZ 0ump on CX equal to Zero) transfers program control to the target operand if 
the CX register is equal to zero. For example: 


MY.LOOP JCXZ 
MY^LOOPl IN 
OR 

LOOPZ 

OUT.OF^LOOP 


OUT^OF^LOOP 
PL,PTR.PORT 
PL, PL 
MY^LOOPl 

NIL 


;If CX is 0, do not execute the loop. 
;6et data from port. 

;Set flags. 

5 If data from PTR^PORT is zero. 

;Get another byte. 

;Program winds up here. 


If CX equals zero on entry to the routine, control is passed to the program label 
OUT_OF_LOOP. The loop is not executed. 


Interrupts 


The three interrupt instructions are used to transfer control to another part of the 
program. Interrupts can be externally generated, or they can occur via the INT or 
INTO instructions under program control. When the 8088 encounters one of the 
two possible software generated interrupts, the 8088 pushes the flag register onto 
the stack (similar to PUSHF), clears IF and TF in the flag register, and fetches a 
double word entry in an interrupt vector table stored in memory at OOOOOH to 
003FFH. 

There are 256 different possible interrupt types, each with its own entry in the 
table. Once the 8088 has cleared IF and TF, the stack pointer is decremented by 2 
and the current value of the code segment register is saved on the stack. Next, the 
8088 calculates the absolute memory address of where the segment vector is 
stored. The interrupt type (0-255), is multiplied by 4 and added to 2 (TYPE * 4 
+ 2). This is the segment address of the interrupt service routine. The word stored 
at this location is then placed into CS. 

In a similar manner, the stack pointer is again decremented by two, and IP is saved 
on the stack. The offset vector address is calculated by multiplying the interrupt 
TYPE by four. The word stored at this location is then placed into IP and becomes 






122 80881IBM PC Assembly Language Programming 


the new segment offset. The next instruction to be executed is specified by the 
combination of the code segment register (CS) and the instruction pointer (IP). 

INT- 

Format: INT interrupt type 

INT (INTerrupt) is one of the more powerful instructions the 8088 is capable of 
executing. With it, you are able to invoke an interrupt service routine specified by 
the type operand coded into the instruction. For example: 

INT 21H jPerform a type 33 interrupt. 

As you’ll discover in the following chapters, this interrupt type is used by MS-DOS 
to handle different system services, such as sending a character to the screen. 

Now direct your attention to Table 4-4. Notice that there are five reserved and 
defined interrupts listed in the table. They are: 

Type 0 - Reserved for division by zero 

Type 1 - Reserved for single stepping 

Type 2 - Reserved for Non-Maskable Interrupts (NMI) 

Type 3 - Reserved for 1-byte INT instruction 

Type 4 - Reserved for signed overflow interrupt (INTO) 


Table 4-4 

Intel 8088 Interrupt Vectors 

Interrupt Type 

Memory Location (Absolute) 

Definition 

0 

0000 

(IP) 

Divide Error 


0002 

(CS) 


1 

0004 

(IP) 

single Step (TF) 


0006 

(CS) 


2 

0008 

(IP) 

Non-Maskable Interrupt 


OOOA 

(CS) 


3 

OOOC 

(IP) 

Breakpoint Trap 


OOOE 

(CS) 


4 

0010 

(IP) 

Overflow Trap 


0012 

(CS) 



NOTE! (Types 5 -31 reserved by Intel) ♦♦♦♦♦♦♦♦♦♦♦ 

5 

0014 


Screen Print 

6 

0018 



7 

001 c 



♦ * NOTE! Types 08H through OFH are generated by the 8259 Interrupt controller ♦ * 

08H 

0020 


Timer (8253) 

09H 

0024 


Keyboard 
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Table 4-4 

Intel 8088 Interrupt Vectors 

Interrupt Type 

Memory Location (Absolute) 

Definition 

OAH 

0028 

Color Board 

OBH 

002C 

N/A 

OCH 

0030 

Serial Adapter 

ODH 

0034 

N/A 

OEH 

0038 

Disk 

OFH 

003C 

Printer 


BIOS Interrupts 

ii^iti************* 

10H 

0040 

Video (BIOS) 

11H 

0044 

Equipment Flag 
(BIOS) 

12H 

0048 

Memory Size Check 

13H 

004C 

Disk I/O 

14H 

0050 

Serial I/O 

15H 

0054 

Cassette I/O 

16H 

0058 

Keyboard I/O 

17H 

005C 

Printer I/O 

18H 

0060 

BASIC 

19H 

0064 

Bootstrap 

1AH 

0068 

Time of Day 

1BH 

006C 

Keyboard Break 

1CH 

0070 

Timer Tick 

1DH 

0074 

Video 

Initialization 

1EH 

0078 

Diskette Parameters 

1FH 

007C 

Video Graphics 


MSDOS Interrupts 


20H 

0080 

Program Terminate 

21H 

0084 

DOS Function Call 

22H 

008C 

Terminate Address 

23H 

0090 

Fatal Error Vector 

24H 

0094 

Absolute Disk Read 

25H 

0098 

Absolute Disk Write 

26H 

009C 

Terminate, Stay 

Resident 

27H-5FH 

0100-017F 

Reserved 

60H-67H 

0180-019F 

User Interrupts 

68H-7FH 

01A0-01FF 

Not Used 

80H-0F0H 

0200-03C3 

BASIC 

0F1H-0FFH 

03C4-03FF 

Not Used 


Table 4-4 Notice Intel reserves interrupts 5-31 (OSH - 20H) for future use. The 80188/86, and 80286 are 
newer and more powerful processors from Intel which use the vectors which are reserved on 
the 8088. However, IBM decided to use these Interrupt vectors for processing many of the 
BIOS (Basic Input/Output System) functions In ROM in the PC. 
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Intel reserves interrupt types 5-31 for future use. IBM chose to use these interrupts 
on the PC. This is one possible source of incompatibility when comparing a 
compatible computer to an IBM PC. 

INTO-- 


Format: INTO 


INTO (INTerrupt on Overflow) generates a type 4 interrupt if the overflow flag is 
set in the status register. If OF is not set, the instruction following the INTO 
instruction is executed. It is used to handle an overflow condition resulting from 
arithmetic operations. For example: 

SBB PX,BX 9 Subtract with borrow BX from AX 

INTO 9 Interrupt if overflow. 


causes an interrupt type 4 to be generated if, as a result of the subtraction, the 
overflow flag is set. 

IRET- 


Format: IRET 


IRET, or Interrupt RETum, terminates every interrupt service routine. The instruc¬ 
tion passes control back to the main program by popping IP, CS, and the flags from 
the stack. These values are automatically pushed on the stack anytime the 8088 
receives an interrupt. 



String instructions manipulate blocks of data stored in memory. They require that 
the destination operand be pointed to by DI and that the source pointer be in SI. If 
the direction flag (DF) is set, then DI and SI are automatically decremented after the 
string operation has been executed. If the direction flag is clear, the pointers are 
incremented after the string instruction has been executed. 





















8088 Instruction Set 125 


Due to the use of the index pointers SI and DI and the association they have with DS 
and ES, it is implied that the source string resides in the data segment (DS:SI) and 
that the destination string resides in the extra segment (ES:DI). If there was no 
flexibility allowed in the addressing of operands, these otherwise powerful 
instructions would become cumbersome and awkward to use. 

There is a way to overcome this otherwise serious limitation in operand string 
addressing. This allows the addressing of source and destination strings that are 
both in either the data segment or the extra segment. More on this in a moment. 

Operands must be specified in the instruction so that the assembler can determine 
what type of string instruction it is to generate, byte or word. The assembler 
determines this from the TYPE attribute assigned to each operand when it is 
defined. For example, MY_DATA_STRING DB OFFH assigns MY_DATA_STRING a 
type attribute of BYTE. If the DW pseudo-op were used to define the string, then 
the type attribute would be WORD. 

Based on this information, the assembler generates either a MOVSB or MOVSW 
instruction. Simply loading the index registers with the address offset of the data 
referenced is not enough, however. The assembler cannot determine the type 
attribute from the index registers; therefore, the operands must be included in the 
instructions when using the generalized form MOVS, CMPS, SCAS, LODS, and 
STOS. 

If you use the short forms of the instructions, such as, MOVSB, MOVSW, CMPSB, 
CMPSW, SCASB, SCASW, LODSB, or LODSW, the operands do not have to be 
included in the source statement. The assembler is able to generate the proper 
instruction, as the data type is specified in the source statement. 


Prefix Operators 


REP, REPZ, REPNZ--- 

A prefix operator may be specified in the instruction, and it is used when you want 
to repeat the string instruction a certain number of times. The instruction is 
repeated until the contents of CX meet the specified criteria. For example, the REP 
operator is used when repeating an operation until CX equals zero. REPZ causes the 
operation to be repeated as long as the count in CX does not equal zero and ZF is set 
to one. It is similar to the LOOPZ instruction previously discussed. REPNZ repeats 
the specified operation as long as the count in CX is not zero and ZF is clear (zero). 







MOVS moves a byte or word from the source string to the destination string 
pointed to by SI and DI. MOVS is used to transfer a block of data from one portion 
of memory to another. Although you can override the segment (DS) pointed to by 
the source operand SI during a repeat operation, Intel cautions you not to do this: 
“....avoid using the other two prefix bytes with a repeat-prefixed string instruc¬ 
tion. One overrides the default segment addressing for the SI operand and one 
locks the bus masters. Execution of the repeated string operation will not resume 
properly following an interrupt if more than one prefix is present preceeding the 
string primitive. ” 

MOV CX,1024 
STD 

LEO SI,MY_DfiTn_STRIN8 
LEO DI,ES:DI,MY^DPT0_STRINB2 
REP MOVS CDI],ESiCSI3 

The instruction above can be used to move data from one part of the extra segment 
to another part of the same segment. However, the instruction is not guaranteed to 
operate properly on returning from an interrupt. What can you use to move data 
from one location within the same segment (ES)? Try this: 

ASSUME DS > EXTRP.SEGMENT,ESIEXTRP.SESMENT 

MOV PX,EXTRft^SEGMENT ;Establish seg. registers 

MOV DS,AX ;Set up DS register 

MOV ES,AX |Set up ES register 

MOV CX,COUNT ;Load repeat counter 

STD ISet direction flag 

LEA SI,MY_DATA_STRINQ ;Load source string DSsSI 

LEA DI,ES:MY_DATA_STRING2 ;Load destination string ESsDI 

;Move data from extra seg. to extra seg. 


;Set up counter for IK block move 
;Set the direction flag 
;Get source address 
;Get destination address 


REP MOVS CDI3 ,ISll 
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By using the ASSUME statement, both DS and ES are set to the start of the extra 
segment. When the repeated move string instruction is encountered, data is moved 
from one part of the extra segment to the other. You can also use this programming 
quickie to move data from one part of the data segment to another. Simply set both 
DS and ES to the start of the data segment rather than using the extra segment. 

Another alternative is to use the LOOP instruction to transfer a block of data from 
one part of the extra segment to another part of the extra segment. Using the LOOP 
instruction allows you to use the segment override operator with the source 
operand. For example: 

LEft DI,ESsMY_STRINe jSet up destination string pointer 

LEft SI,MY_STRINB2 {Set up source string pointer 

gXD iSet direction flag 

MOV CX,1024 5 Set up iteration counter 

MOVE_IT MOVS MY^STRING,ES:MY_STRINe2 ;Move string 

LOOP M0VE_IT ;Repeat until CX * 0 

This program code is shorter and less complicated than the previous example, but 
it will not work when both the destination and source strings are in the data 
segment. You will have to again set ES and DS to point to the start, or base, of the 
data segment. This involves using the ASSUME statement as demonstrated before. 

MOVSB and MOVSW do not require operands, as they specify the data type 
attribute directly within the source statement. 

Compare String 


CMPS, CMPSB, CMPSW--- 

Format: CMPS destination string, 
source string 
CMPSB 

_ CMPSW _ 

Often it is necessary to search or scan strings for a matching byte or word value or 
for a byte or word value that differs between strings. CMPS does exactly this and 
sets the appropriate flags in the status register. 

REPZ and REPNZ can be used to repeat the operation until the condition is met. 
REPZ continues to compare the source to the destination string as long as CX is not 
zero and the operands match (ZF = 1). When the operands differ, ZF is cleared, and 
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the next instruction following the CMPS is executed. In most cases, the instruction 
following the CMPS will be a conditional jump instruction. 

REPNZ is used to compare strings for a matching byte or word. The operation is 
repeated as long as CX is not zero and ZF is cleared. 

An example of the CMPS instruction is: 


LEA 

SI,MY_STRINB 

{Set pointer to source string 

LEA 

DI,ESiMY_STRING2 

{Set pointer to destination 

STD 


{Set direction flag 

MOV 

CX,1024 

{Set counter to 1024 bytes to 
{compare. 

REPZ 

CMPS MY_STRING2,MY_STRING 

{Find a byte th*at differs. 

JZ 

GOT_ONE 

{ ZF='l’, then got a match. 

JMP 

EXIT 

{Else leave routine 


0QT_ONEi LOOS MY_STRINS {Load string value and inc. SI 

EXIT: RET 

The compare string instruction updates all the flags of the status register and, like 
the CMP instruction, affects neither operand. CMPSB (byte compare) and CMPSW 
(word compare) do not require operands, as the data type operator is specified in 
the source statement. 


Scan String 


SCAS SCASB, SCASW- 

Format: SCAS destination string 
SCASB 
SCASW 


The SCAn String instruction compares AL (byte) or AX (word) to the destination 
string. If you want to search memory for the ASCII letters IBM, use the SCAS 
instruction as follows: 

LEfi DI,ESiMY_8TRlNG |Set up destination string 

$Assume Memory defined as words 

MOV CX,1024 


STD 


{Search IK of memory 
{Scan backwards 
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MOV ftH," 

MOV ftL, "M” 

SCftN_MEM« REPZ OCRS MY.STRINO 

JZ eOT_MflTCH_l 
JMP EXIT 

QOT_MflTCH_ONE MOV RH,"B" 

MOV RL,"I" 

SCRS MY.STRING 
JZ GOT_IT_RLL 
EXIT! RET 


;Set up valu# to search for 
9 

;Scan for a match 
$Continue if there is none 

$6ot it, good 

{Otherwise stop searching 

{Next 2 bytes must match 

{value in AX 

{Next word match? 

{Yes jump to new part of program 

{No, then leave routine. 


The memory scan terminates if CX = 0 or a match is not found in the loop. It also 
terminates if the second scan fails to find the letters IB. 

You can also use the implicit forms of SCAS; they are SCASB (scan for byte) and 
SCASW (scan for word). These instructions do not require an operand, as the data 
type of the destination operand pointed to by DI is specified in the instruction. The 
assembler is able to generate the proper instruction (byte or word scan), as the data 
type attribute is specified in the source statement. 

DI is updated after the execution of the SCAS instruction to point to the next data 
element. If DF is clear, DI is incremented. If DF is set, DI is decremented, as in the 
example above. 


Load String 


LODS, LODSB, LODSW 

Format: LODS source-string 
LODSB 
LODSW 


LODS (LOaD String) transfers a byte into AL or a word into AX. SI must point to the 
source string, and it is updated after.the instruction’s execution to point to the next 
data element. Although you could specify a repeat prefix as part of the instruction, 
this is not usually done. Since AL would only retain the last value fetched from 
memory, repeating the operation makes little sense. It is useful, however, when 
you need to load a value from memory and automatically update the pointer. 
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An example of the LODS instruction is: 
LEft SI,MY_STRING 
LEA DI,E88MYSTR1N62 
STD 

REPZ CMPS MY_STRING2,MY.STRIN6 

JNZ FOUND.ONE 
EXITI RET 

FOUND.ONEs LODS MY.STRING 


;Set up source pointer 

$Set up destination string 

;Set direction flag 

;Compare strings for 
$difference 

;Found one 

;None found return 

5Get the element that differs STOS 


Store String 


STOS, STOSB, STOSW — 

Format: STOS destination string 
STOSB 
STOSW 


The STOre String instruction transfers a byte from AL or a word form AX to the 
destination operand pointed to by DI. STOS is most frequently used in initializing 
data areas to a constant value. Often it is necessary to clear a data area prior to using 
it in a program. STOS provides a convenient way of doing just that. For example: 


LEO DI,ES«MY_STRIN6_ftREft 
MOV CX,2048 
OV AX,0 

REP STOS MY_STRlNS_DftTft 


{Set pointer to data area 
sCt»ar &04S words <4096 bytes) 
jValue to store 
{Repeat until CX - S 



These instructions govern the 8088 during program execution. They control the 
microprocessor and affect the manner in which the 8088 executes other instruc¬ 
tions. 
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No Operation 


NOP 


Format: NOP 


The NO operation instruction can be used as a time filler or to fill an area in memory 
which can be used to patch the program when bugs are discovered. When the 8088 
encounters the NOP instruction, it does nothing. NOP does not affect any of the 
flags. 


Carry Instructions 


CLC, CMC, STC 


Format: CLC 


CMC 

STC 


These three instructions affect the carry flag. CLC clears the carry, STC sets the 
carry, and CMC complements the carry bit (reverses its state). As the instructions 
implicitly designate the carry bit, they require no operands. 

Some examples of their usage are: 

EXAMPLE 1: CLC 

;Condition the carry bit for the following 
;rotate instruction. 

RCL 

;Rotate left through carry 

;the 0 originally in the carry is 

;now in B0. 

EXAMPLE 2: STC 

;Set the carry flag to 1 

NCR 

;Stuff a 1 into b7 and put b0 in carry. 

9 jl mp 

Format: CLD 


STD 



These instructions affect the direction flag, DF. CLD is used to clear DF and causes 
the index register(s) to be automatically incremented during execution of the string 
instructions. STD is used to set DF and causes the string instructions to automati- 
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cally decrement the pointer(s). See the previous discussion on string operations for 
examples of their usage. 


Interrupt Instructions 


CLI and STI 


Format: CLI 
STI 


CLI (CLear the Interrupt flag) and STI (SeT the Interrupt flag) are used to enable or 
disable external interrupts. CLI disables external interrupts, while STI enables 
them. There are maskable and nonmaskable interrupts. Nonmaskable interrupts 
are always honored; they cannot be disabled by clearing IF. 

Masking interrupts is common when you don’t want an external event to interrupt 
the microprocessor. Going back to the human analogy of Chapter 3, using the STI 
instruction is a little like hanging a sign outside your door, that says “DON’T BUG 
ME, I’M BUSY!’’ When you are able to answer the door, you use the CLI instruc¬ 
tion, which removes the sign from the door and enables interrupts. 


Delay Instructions 


HLT and WAIT 


Format: HLT 
WAIT 


Have you ever had to wait for an important message and sat around waiting for the 
telephone to ring? The WAIT instruction puts the 8088 into an idle or wait state. 

One of the pins on the 8088 microprocessor is used as an input signal and is called 
TEST. As long as this line is inactive, the 8088 waits for either the TEST input to 
become active or for an external interrupt to occur. No other instructions are 
executed while the 8088 is waiting. 

When the TEST input becomes active (logic 0, or 0 volts), the 8088 executes the 
instruction following the original WAIT instruction. Should an external interrupt 
occur, the 8088 saves the address of the WAIT instruction on the stack and vectors 
to the appropriate interrupt service routine. When the interrupt has been serviced, 
the address of the WAIT instruction is popped from the stack, and the 8088 
reenters the wait state. 
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The HLT (HaLT) instruction is similar to the WAIT instruction, in that they both put 
the 8088 into an idle condition. But unlike the WAIT instruction, HLT does not 
sample the TEST input. When halted, the 8088 waits for a reset, or an enabled 
maskable or nonmaskable interrupt. Once the interrupt occurs, the halt state is 
cleared. Both the HLT and WAIT instructions are used to synchronize the 8088 to 
external events. 


Instructions to 
Other Processors 


ESC and LOCK 


Format: ESC external 

op-code,source 
LOCK op-code destination 
operand,source operand 


ESC (Escape) is used to send instructions to other processors, such as the 8087 
numeric co-processor. When the 8088 encounters the ESC instruction, the pro¬ 
cessor executes a NOP instruction. The only other operation that the 8088 per¬ 
forms is to address the source operand specified. The external op-code must be a 6- 
bit number and is composed of 3 bits indicating the co-processor that the instruc¬ 
tion is intended for and 3 bits designating the instruction the co-processor is to 
execute. If the operand is in memory, the 8088 reads its value and ignores it. The 
co-processor, however, also reads the value and uses it as the source operand in its 
operation. 

LOCK is not an instruction, but rather a 1-byte prefix to an instruction. It is used to 
LOCK other processors out of the system for the duration of the instruction. When 
the 8088 encounters the LOCK prefix byte, it asserts a signal on the LOCK pin of 
the microprocessor. The LOCK signal remains active during the execution of the 
instruction. 

It is common when two or more processors share resources, such as memory, that 
RAM semaphores are used to communicate between them. LOCK prevents another 
processor from inadvertently changing a semaphore while the semaphore is also 
being altered or read by the first process. 

Imagin e what would happen if both you and your spouse were to make a major 
purchase. Your spouse has just purchased a new car for your birthday present but 
has not changed the balance shown in your bankbook. It so happens that you too 
have made a major purchase, a trip for two on a Caribbean cruise. Unfortunately, 
the combined cost of both purchases is more than what you have in savings. 
Perhaps what you need is a LOCK on your savings book that would have prevented 
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one of you from making a major purchase until the balance was recalculated and 
written in the checkbook. The LOCK prefix does exactly that. 



1. Write the necessary program statement(s) to add 20 to the memory location 
COUNTER. 

2. There are_major groups of 8088 instructions. 

3. Write the program statements that will compare a value in the memory 
location COUNTER to 20 and branch to the program label THERE if the value 
in COUNTER is equal to 20. 

4. What does this instruction sequence do? 

XORAX,AX 

5. What is wrong with this statement: 

MOV 10H,AL 

6 . What is wrong with this statement: 

MOV FACEH.AX 

7. For every PUSH there must be a_. 

8 . Write a program loop that will clear 64 bytes of memory. Begin clearing 
memory at the label DATA_STRC. 

9. Write two statements that will load the offset address of COUNTER into the 
register BX. 

10. List two variations of the LOOP instruction. What does each do when 
executed? 














Until now, I have refrained from using all but the minimum of assembler features in 
the programming examples. Although the IBM Macro Assembler manual provides 
an overview of the directives and pseudo-ops available within the assembler, the 
descriptions often lack adequate examples of their usage. In fact, the manual starts 
out with the statement, “This manual is a reference manual for experienced 
assembler language programmers, like yourself, who use the IBM Personal Com¬ 
puter Macro Assembler.” If you’re not an experienced assembler language pro¬ 
grammer, you must have wondered to whom IBM was referring. 

Therefore, I want to not only discuss the features available within the assembler 
but also give several examples of HOW the features can be used to save you time in 
your programming efforts. 

You do not have to be an experienced programmer to understand this chapter. 
Although this chapter stands on its own, it will be helpful to reread the IBM Macro 
Assembler manual’s description of the features discussed. It’s not my intention to 
eliminate the need for the Macro Assembler manual, but merely to provide alter¬ 
nate explanations in an attempt to clarify the many ambiguities that exist within 
the manual. 
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The format for entering your source programs has been given previously, but I will 
repeat it here. The general form for entering source statements is: 

<"NAME—> <—OP-CODE—> < —operand(s)—> <—comments—> 

The assembler directives and pseudo-ops that define data or control the assembly 
process are entered in the op-code field, which is normally reserved for a valid 
8088 instruction. Pseudo-ops allow you to define data, associate constant values 
with labels (symbolic names), and control the assembly. The types of allowable 
pseudo-ops available within the IBM Macro Assembler fall into four categories: 
data definition (including symbol, procedure, and segmentation definitions), con¬ 
ditional, macro (discussed in Chapter 6), and listing pseudo-ops. 

Because pseudo-ops appear in the source file in the op-code field, it may be 
confusing at first in differentiating between an 8088 instruction (op-code) and an 
assembler directive (pseudo-op). When a name, operand, or comment is required 
with a pseudo-op, the same rules apply to the name field as when a name is required 
for an op-code (see Chapter 2). 



The data pseudo-ops (see Table 5-1) are discussed in the IBM Macro Assembler 
manual beginning on page 5-3. Some of the pseudo-ops may seem self-explanatory, 
while others are not so obvious. 


ASSUME 


Format: ASSUME seg reg:seg 
name!,....] 


ASSUME tells the assembler which segment registers are to be associated with each 
segment. In the general format, seg reg refers to the segment registers CS, DS, ES, or 
SS. Seg name is the name you specify for the given segment. For example: 


ASSUME 


CS:MY_CODE,DS t MYDATA,ES«NOTHING,SS j MY_STACK 
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Table 5-1 
Data Pseudo-ops 


Category I 

Segment Definitions 

ASSUME 

SEGMENT 

ENDS 

ORG 

GROUP 

EVEN 

Category III 
Procedure. Related 

PROC 

ENDP 


Category VI 

Record/Structure Related 

RECORD 

STRUC 


Category II 
Data Definitions 

DB (Define Byte[s)) 

DW (Define Word[s|) 

DD (Define Double word[s|) 
DO (Define Quad-Word[s|) 
DT (Define Ten-Bytes) 

Category IV 
Symbol Definitions 

EQU 

LABEL 
Category VII 

Module/Assembler Related 

NAME 

•RADIX 

PUBLIC 

EXTRN 

INCLUDE 

END 


informs the assembler to associate the CS register with the segment defined with 
the label MY_CODE, and DS with the segment labeled MY_DATA. ES is associated 
with nothing. This means that any previous assumptions about the ES register are 
canceled. The segment registers can appear in any sequence, and all four need not 
be present. 

You may want to cancel a previous assumption about the DS register; in which 
case, the statement: 

ASSUME DSiNOTHINS 

would be all that is required. Figure 5-1 illustrates how the assembler associates 
segment, base, and index registers with each of the four possible segments. You 
can have more than one of the segment types in your program (e.g., two code 
segments), but only one of each segment type is active at iny given time. 

Although the assembler has been informed via the ASSUME directive to associate 
certain segment registers with the various segments in a program, the segment 
registers themselves must contain the proper base address for the given segment. 
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Figure 5-1 ASSUME Directive 


Example: 


ASSUME CS1MY.CODE, DSi 

[ MY^DATA,ES s MY^DATA,SS s MY^STACK 

MOV 

nX,MY_DftTft 

;Set up segment registers 

MOV 

DS, AX 

5 Transfer seg~base to DS 

MOV 

ES, AX 

$Do the same for ES 


You should notice that the segment registers cannot be used as destination oper¬ 
ands in immediate move instructions. The segment base address must first be 
moved into a general purpose register (usually AX) and then transferred to the 
proper segment register. Additionally, CS cannot be used as the destination oper¬ 
and of any move instruction. 

SEGMENT- 


Format: seg name SEGMENT 

[align] [combine] [class] 


ENDS- 

Format: seg name ENDS 


These pseudo-ops are used to define a segment. There must be a segment for your 
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program code, data, and stack. Since there are two data segment registers, DS and 
ES, your program can contain two different active data segments at a given time. 
The programming example in Listing 2-1 contains a data segment, a stack segment, 
and a code segment. 

Use the SEGMENT and ENDS pseudo-ops in the following manner to define your 
segments: 

MY.STftCK SEGMENT PftRft STOCK 'STOCK* 

DW 100 DUP(?> 

MY_STOCK ENDS 

MY.OOTO SEGMENT PORO 'DOTO* ;Oefine data segment 

TABLE! DW 100 DUP<0) {Define 200 bytes of zeros 

• <More data definitions> 


MY^DATA ENDS 

MY.CODE SE6MENT PARA «CODE« {Define code segment 

ASSUME CS 8 MY.CODE,DS:MY^DATA, SS s MY.STACK 


MY.CODE ENDS* 

In the preceding example, the code segment is defined to have an align type of 
PARA, which aligns the segment on a boundary address that is divisible by 16. The 
class type must be enclosed in single quotation marks and is used by the linker to 
combine segments with identical class names. The stack segment uses the combine 
type, which in this case is STACK. The linker requires there to be a stack segment 
defined when the combine operator is present. See Chapter 5 in the IBM Macro 
Assembler manual for a full description of the optional align, combine, and class 
operands. 

PROC- 

Format: procedure name 
PROC [NEAR] 
or 

procedure name PROC FAR 
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ENDP- 

Format: procedure name ENDP 


The concept of modular programming is based upon building small, unique blocks 
of code. Each block of code performs a specific task. Modularity is beneficial for 
several reasons. Smaller chunks of code are easier to debug than a large program. 
The code is also easier to understand. Procedures reduce the amount of code 
required in a given program by generating the object code required for a specific 
function once and allowing the code to be used by other parts of the program. 

PROC defines a section of code as a procedure. Old-timers to ALP will recognize 
that procedures are what used to be called subroutines. A RET (return) instruction 
returns control to the calling program. 

If the PROC is defined—as with a distance attribute of NEAR (within the same 
segment as the calling program), then the assembler generates a RET instruction 
that restores the offset contained in IP before the procedure is called. If the 
procedure is defined as being of the FAR type, then the RET instruction restores 
both IP and CS to the segment offset and segment of the calling program. NEAR is 
used for intrasegment calls, and FAR is used for intersegment calls. 

Example; 

MY.PROC PROC NEAR {Cattable from same segment. 


RET 

MY_PR0C ENDP {End of procedure. 

PUBLIC DIFF_SES_PROCEDURE 

0IFF_8EG_PR0CEDURE FAR 5 Procedure to be called by other 

$segments 


RET 

DIFF.SEB.PROCEDURE ENDP 

Notice that the procedure must not only be declared FAR, but it must also be 
declared PUBLIC. This allows other programs not defined in the module to refer¬ 
ence the procedure. ENDP terminates the portion of code and the definition of the 
procedure. 
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Defining Data 


DB, DD, DW, DQ, DT - 

Format: name Dx expression 
(Where x is either 
B,D,W, Q, orT) 


These pseudo-ops allow you to define a variable or initialize storage locations. The 
pseudo-ops may be preceded by a symbolic name and must be followed by an 
expression. The second letter of the designation defines the TYPE attribute associ¬ 
ated with the storage location(s). For example: 

ONE.BYTE DB ? 

defines 1 byte of storage. The ? indicates that the byte is not initializ ed to any 
particular value. You can also define more than one byte of storage as in: 

DECIMAL.TABLE DM 10000,1000,100,10 

These pseudo-ops are used to establish data areas and tables necessary for program 
execution, character code translations, etc. In Listing 2-1, another use for the DB 
pseudo-op was demonstrated: the creation of ASCII message strings. For example: 

MESSnUE.ONE DB 'This is the first message I want to define.’ . 

DB 

In this example, the string appears in memory exactly as it appears between the 
single quotation marks. The second DB defines a hyte containing 24H, the ASCII 
code for the dollar sign. 

Similarly, DW, DD, DQ, and DT define words, double words (4 bytes), quad words 
(8 bytes), and 10 bytes of storage. 

DUP- 

An operator which may be used with any of the data definition pseudo-ops is the 
DUP (duplicate) operator. The DUP is used to create or initialize data storage. For 
example: 


DM 100 DUP<?) 
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defines 200 bytes of uninitialized storage. You can specify any valid initialization 
value in the DUP clause. For example: 

DM lee DUP<e> 

initializes 100 words of storage to OOH. The IBM Macro Assembler manual discusses 
each of the data definition pseudo-ops in detail. 



Attributes and Operators 


Symbolic names carry with them more than what you put into them. You may 
choose a symbolic name that really describes a function of the code where the label 
is placed. For example: 

FIND_SQUftRESi 

may do just that, find the square of a number. However, the assembler assigns its 
own meaning to the label (it really doesn’t know that the statements following the 
label actually do find the square of a number). The meanings the assembler assigns 
to the labels are known as attributes. They describe how the label is used. 

Segment Attribute ■ ■ 

Each label has a segment attribute associated with it. It is the value of the beginning 
of the segment where the label is defined. For example: 

MY.DftTft SEGMENT PfiRfi ’DATft’ 

ASCII DB 128 DUP(?) 

MY.DATA ENDS 

assigns the segment attribute of ASCII the value of MY_DATA. The segment register 
(DS, in this example) must contain the segment value in order to access the label 
ASCII. In order to find the segment value of ASCII, you would use the value¬ 
returning operator SEG: 

MOV AX, SEO ASCII 


MOV DS,AX 


;6et segment value of ASCII 
5 Set up segment register 
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Offset Attribute 
and Operator 

By now you should know that whenever there is a segment, there is an offset into 
the segment. An offset attribute is associated with every label in a program. The 
offset for ASCII in the above example is zero. The first byte of data defined by the 
label ASCII is zero bytes from the beginning of the segment where it is defined. The 
offset attribute is a l6-bit unsigned value. You can use the value-returning operator 
OFFSET to load the offset value into a register: 

MOV DI,OFFSET ASCII ;Oet offset of label ASCII 

Remember, this instruction moves the offset from the beginning of the segment 
where the label is defined, into the specified register. It does not move the contents 
of the memory word into the register. 

Type Attribute 
and Operator -. . 

Along with a segment and offset attribute associated with a name, the assembler 
associates a type attribute with the symbolic representation. This attribute defines 
the number of bytes reserved for the symbol. If a symbol is defined as follows: 

COUNTER DM ? {Ths TYPE attribute is word. 

The DW pseudo-op is used to Define a Word of storage for the label COUNTER. 
Therefore, the type attribute is word (2 bytes). 

In using the instruction: 

MOV AX,TYPE COUNTER 

the value of 0002H is returned to AX. 

There is also a distance attribute associated with memory locations. It informs the 
assembler whether the memory location is defined as a NEAR or FAR type. For 
example: 

SQUARES! MOV AX,VALUE ;6et number to square 

defines SQUARES as having a NEAR attribute. The type operator can be used to 
return the value ( — 1 for NEAR and — 2 for FAR attributes) based on the distance 
attribute of the symbol. 

Example: 

MOV AX,TYPE SQUARES ;Mill return a -1 
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The po$sible type values are given in Table 5-2. 


Table 5-2 

Values Returned by TYPE Operator 

TYPE 

VALUE RETURNED 

DB 

1 

DW 

2 

DD 

4 

DQ 

8 

DT 

10 

NEAR 

-1 

FAR 

-2 


LENGTH and SIZE 
Operators . 

The value-returning operators LENGTH and SIZE are used in conjunction with the 
type operator. If you define a table of data as: 

MY.TftBLE DM 10 DUP(?) » 

the LENGTH operator returns the value used to specify the number of times you 
want to duplicate the word. The SIZE operator returns the size of the data type as 
LENGTH X TYPE. Since the variable in this example is a word, the type will be 2. 
The operator length is 10; therefore, the size of the variable will be equal to 
LENGTH X TYPE = 10 X 2 = 20 bytes. 

These operators are useful in moving the LENGTH and SIZE values into the count 
register (CX) prior to an iterative loop. For example: 

MOV CX,LENGTH MY.TftBLE 

moves the length of MY_TABLE into the CX register. In this instance, the LENGTH 
operator returns the total number of word entries in the table, which is 10. 

In a similar manner, the SIZE operator returns the total number of bytes allocated 
to the variable. For example: 

MOV CX,8IZE MY_TfiBLE 

returns the value 0014H (20 decimal) to the CX register. LENGTH and SIZE have 
relevance only when the variable has been duplicated (DUP). 
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EQU 

Format: name EQU expression 

The equate pseudo-op assigns the value in the expression field to the symbolic 
name that precedes the EQU pseudo-op. Some examples of the use of EQU are as 


follows: 




THOUS 

EQU 

1000 

;THOUS equated to 1000 

NEG.VftL 

EQU 

-5000 

;NEG_VAL equated to minus ' 

COMP_V«L 

EQU 

TH0US*5 

;Computed as 5 thousand 

COUNT^REB 

EQU 

CX 

;Represent the CX register 


Notice that you can use arithmetic operators within the statement and let the 
assembler compute the values. I will discuss arithmetic operators later in this 
chapter. The name used with the equate statement is mandatory and must not be 
followed by a colon. 

You can also use a label to represent another label or a register. In the examples 
above, COUNT_REG is equated with register CX. If you use labels to represent the 
registers of the 8088, define them prior to using them in your program. If you do 
not define them prior to their usage, the assembler will generate an error. Labels 
that are found to be names for the 8088’s registers cannot be forward referenced. 


Format: name = expression 


The = (equal) pseudo-op works in a manner similar to the EQU pseudo-op with 
one major exception; equal allows you to reassign the symbolic name to a new 
value. You cannot do this with the EQU pseudo-op. 

Assume for a moment that you want to assign different values to the name 
MAIN_COUNT. The constant will be used to load a count value in one of several 
different delay routines. You could use the = pseudo-op to redefine the label 
within the program. Often this is done at the beginning of a module that needs to 
use a label, with a different value than the one previously assigned. 


















146 8088!IBM PC Assembly Language Programming 


Examples: 




MAIN.COUNT 

ss 

1000 

;Value of MAIN.COUNT * 1000 

MAIN^COUNT 

- 

10000 

;MAIN_COUNT is redefined. 


LABEL 


Format: name LABEL type 


The LABEL pseudo-op assigns the segment, offset, and type attributes of name. 
Examine the following portion of code; 

ftRRftY_BYTE LfiBEL BYTE jftRRflY.BYTE = Cur-rwnt segment 

;with the offset ^t current 
;byte, and the type attribute 
|of byte. 

ftRRftY^l DU 200 DUP<?) ;This array has 400 bytes 

9 iRfuras) • 

Notice that ARRAY_BYTE is defined just prior to ARRAY_1. Therefore, the seg¬ 
ment is the same for both names, as is the offset of the first byte. However, the array 
can now be accessed in either of two ways, by byte or word. We already know that 
the statement: 

MOV ftL,ARRftY_l 

generates an error, because the source and destination are not the same size 
(byte/word). However, by using the LABEL pseudo-op in the manner shown above, 
you can access a byte within the array, as in: 

MOV PL,nRRPY^BYTE 

You can also use the LABEL pseudo-op to define an entry point in your program as 
FAR, which would allow other segments to call or jump to that portion of code. 

Example: 

PUBLIC BET^CHARF 

6ET.CHARF LABEL FAR IDefine as FAR 

GET.CHARs IN AL,DATA.PORT ;NEAR attribute 


allows the routine to be called either by code within the segment (NEAR calls and 
jumps) or by code in a different segment (FAR calls and jumps). 
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EXTRN- 

Format: EXTERN name:type[,...] 


PUBLIC- 

Format: PUBLIC symbol 

These pseudo-ops declare symbols and names used in the present module as being 
defined either in another module (EXTRN) or in this module and accessible by 
others (PUBLIC). This again points to the use of structured and modular software. 
You may need to use routines or data which have been defined in other modules; 
EXTRN and PUBLIC allow you to do this. Both modules will ultimately reside in 
the same segment. 

Example: 

MY_C0DE1 SEGMENT 

PUBLIC SINE ;Sine routine defined as public. 

SINE8 MOV PL,VPLUE ;Routine to find the sine of an angle. 


RET 

MY^CODEl ENDS 
MY.CODEl SEBMENT 

EXTERN SINE:NEflR |The name 'SINE’ is not 

;defined in this module. 


CALL SINE 


;In other module, same segment. 


MY CODEl ENDS 


In the example above, the routine to find the sine of a given value is in another 
module. Therefore, the label is declared PUBLIC in the module where it is defined 
and external (EXTRN) in the module that calls the routine. 
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COMMENT- 

Format: COMMENT delimiter text delimiter 

In previous chapters, I have always used a leading semicolon prior to a comment 
line. That is one method you could use to enter comments into a source program. 
However, there is another method you can use to comment your programs. Until 
this chapter, all comments have been entered as follows: 

MOV ftX,MY_DATft ;6et the segment start address 

MOV DS,AX ;Initialize the data segment 

;register. 

The IBM Macro assembler allows you to enter a comment block without beginning 
each comment line with a semicolon. The COMMENT pseudo-op can be used as 
follows: 

COMMENT * You can enter a block of comment lines 
(as many as you like), after the delimiter 
character, which is the first nonblank character 
following the pseudo-op. The block must end with 
the same character as that which opened the 
block (asterisk). Use this pseudo-op to enter 
a description of the program. * 


You can choose any character you want as the delimiter character. It is a conven¬ 
ient way to document your programs. 

ORG- 

Format: ORG expression 


This pseudo-op sets the assembler’s location counter to the value specified. At 
times it is necessary to specify absolutely where a portion of code or data is to 
reside (as in PROM resident data). ORG lets you specify where the code will be 
assembled in memory. The use of the ORG pseudo-op forces the assembler to 
create an absolute (nonrelocatable) object deck. 

When the $ (dollar sign) is used with ORG, the current value of the location counter 
is referenced. You can use this feature to assemble code at some specified offset 
from the current value of the location counter. For example: 
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0R6 *-«-0AH 

sets the location counter to the tenth byte from the current value. Figure 5-2 
illustrates this concept further. Other examples of the use of ORG are: 

□R6 O1F0H jSets location countar to 01F0H 

0R6 0FF0H ;Sets the location counter to 0FF0H 



ORG 

100H 

;Set assembier location 
:counterto0100H 


DB 

20H DUP (41H) ;Define 32 bytes 


ORG 

$ + 40H 

;Skip 64 bytes and start 
;at120H + 40H = 160H 


DB 

20H DUP (42H) ;Define 32 more bytes 



MEMORY 


100H 

— > 

41H 

Which is ASCII‘A’ 

101H 

I 

—-> 

41H 

1 


I 

11FH 

— > 

1 

41H 

End of first DB data area 

120H 

-—> 

? 

Not defined 

121H 

I 

—-> 

? 

i 


I 

15FH 


1 

? 


160H 

-—> 

42H 

Which isASCil'B’ 

161H 

I 

-—> 

42H 

1 


I 

17F - 

“> 

1 

42H 

End of 2nd DB data area 

180H 

-—> 

? 

Not defined 


Figure 5-2 ORG Directive 


The ORG statement is used to manipulate the assembler’s location counter. In 
Figure 5-2, a 32-byte data area is defined, starting at location lOOH. The next data 
area is set to the current value of the location counter plus 40H (160H). The 
locations from 120H to 15FH are not defined or initialized. 

You cannot use the ORG pseudo-op within a STRUC-ENDS definition. 
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EVEN 


Format: EVEN 

(No operands) 


EVEN forces the assembler to align the location counter on an even address. This is 
most often used when creating programs destined for the 8086 processor, which 
will fetch data from memory faster if the data is aligned to an even address. 

If the location counter is at an odd location, EVEN causes the assembler to generate 
a 1-byte NOP instruction and increment the location counter to the next address 
location; otherwise, EVEN does nothing. 

RECORD- 


Format: name RECORD field 

name:width[ = exp],[....] 


RECORD allows the definition of bit patterns used for byte or word bit packing. 
RECORD creates a template for the specified bit pattern; however, you must still 
allocate storage within a data segment for the pattern’s storage. 

The pattern can be from 1 to 16 bits in length. Any RECORD containing a bit pattern 
of 8 bits or fewer will require 1 full byte of storage. A bit pattern of 9 to 16 bits will 
use 2 bytes, or a word. 

Once the RECORD has been defined, storage must be allocated. The general form 
is: 


Cname3 recordname CeKp3 C,.... 3 
or Cname3 recordname exp DUP([!exp3) 


To allocate storage for the RECORD within the data segment use statements similar 
to the following: 


1. Specify your record at the beginning of your program: 

MY.BITS RECORD RECAsA,RECBi4,RECCsA,RECD84 $Record template 
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2. Allocate storage for the record in the data segment: 

MY.DfiTfl SEGMENT PftRA ‘DftTA' 

ERROR.BITS MY.BITS (GGGBB,eelIB,1IGGB,111IB) ;D«finebit 

;patterns 
;and storage. 


MY^DATfi ENDS 

Here a l6-bit pattern of OOOOOOllllOOllllB is defined. Each field within the record 
in this example is 4 bits wide, and there are 4 fields (RECA-RECD) total. Notice that 
the record name becomes the op-code for storage allocation. 

The operators WIDTH and MASK are used to access and manipulate data within the 
record. For example: 

MOV CL,WIDTH RECfl 

moves the width of the field RECA (4) into the CL register. You can use the WIDTH 
operator to move the width of the entire record into a register by using the record 
name rather than the field name as in: 

MOV fiU,WIDTH MY_BITS jMove* 16 <10H) into OL. 

MASK returns a field of I’s for the width of the specified field. In other words: 

MOV BX,MnSK RECC 

moves OOOOOOOOllOOOOOOB to the BX register, and 

MOV BX,MASK RECD 

returns OOOOOOOOOOOOllllB to the BX register. 

If you want to move a field into a register and right-justify the bit pattern for the 
field, first use the field name to obtain the shift count. The shift count is the number 
of bit positions the specified bit pattern must be shifted to right-justify the pattern. 

Example: 

MOV CL,RECB |GET SHIFT COUNT (8) 

MOV BX,ERR0R_BIT8 |GET ALL BITS IN RECORD 

100000011110011116 

SHR BX,CL ISHIFT 8 BITS. 

:00000000000000ii b 
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The only important point to keep in mind is that shift counts are almost always 
loaded into the CL register. When used in a shift or rotate operation, the CL register 
specifies the number of bits to shift the operand (BX, in the example above). 

STRUC - 


ENDS 


Format: structure name STRUC 

variable name (data 
definition pseudo-op) 

• • • 

structure name ENDS 


The STRUC pseudo-op operates in a manner similar to RECORD but allows the 
definition of storage at the byte level rather than the bit level. By using the data 
definition pseudo-ops DB, DW, DD, DQ, and DT, data is defined within the 
structure. Variable names used to define the data can then be used to access data 
within the structure. 

Storage must be allocated in a manner similar to the RECORD pseudo-op. How¬ 
ever, data that is allocated or initialized as single entries can be overridden with the 
allocation statement. Multiple entries cannot be overridden. See the examples in 
the IBM Macro Assembler manual on page 5-43 for more details on overridable and 
non-overridable entries. 

You must reference data in the structure in the following manner: 

1. Define the structure at the beginning of your program: 


AREA STRUC 



WIDTHl 

DW 

? 

1 STORAGE FOR WIDTH 

LENGTH 

DW 

7 

1 STORAGE FOR LENGTH 

AREA 

ENDS 


5 END OF STRUCTURE 


2. Allocate storage within the data segment: 

MV_DftTO SEGMENT PfiRfi 'DftTft* 
nRER.DATA AREA (E5,30) 


MY_DATft ENDS 5End of the structure 
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3. To reference the data, use statements similar to: 

MOV AX,AREA.DATA. MIDTH1 


NAME- 

I Format: NAME module name 


This pseudo-op allows you to assign a unique name to a program module. It is 
usually used at the beginning of the actual program, prior to the actual program 
code. You cannot use a reserved word (8088 instructions or pseudo-ops) as the 
module name. The linker uses either the name assigned to the module or the first 6 
valid characters of the TITLE directive if the NAME pseudo-op is not used. If there 
is no TITLE directive or the characters in the directive are invalid, the source 
filename is used as the module name. 

Example: 

NAME MY_PR06RAM ;Assigns the name of MY_PR06RAM 

$to the module. 

INCLUDE - 


Format: filename 


The INCLUDE statement causes the assembler to include the source code from the 
specified file in the current assembly. The filename must be a valid MS-DOS file 
specification, such as B:MATHFLE.ASM. The source statements are read from the 
file MATHFLE.ASM and assembled into the current source code, beginning at the 
INCLUDE statement. 

The IBM Macro Assembler manual states that ‘ ‘nested INCLUDES are not allowed. If 
they are encountered, then an error message results.” A nested INCLUDE occurs 
when you use the INCLUDE directive and the file specified in the directive contains 
another INCLUDE statement. For example: 

INCLUDE MATHFLE. ASM 

causes the assembler to assemble the source statements of MATHFLE.ASM into the 
current assembly. If MATHFLE.ASM contains another INCLUDE directive, such as: 

NAME MATHFLE.ASM 

INCLUDE FLOAT_POINT. ASM 


an error message is generated by the assembler. 
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GROUP 


Format: name GROUP seg name [,...] 


The GROUP pseudo-op combines the specified segments (seg names) under one 
name, so that they all reside in one logical 64K segment. The total length of the 
combined segments must not exceed 64K. 

The GROUP pseudo-op is another example of a directive which supports the 
concept of modularized programming concepts. For example, you could designate 
two or more code segments within a given module. Perhaps you want these code 
segments and code the segment defined in another module to be combined and to 
all reside in same segment. Figure 5-3 illustrates this. By using the GROUP state¬ 
ment, each specified segment is combined by the assembler into one segment. 

The name field consists of an identifier used by the assembler for combining the seg 
name entries in the statement. In Figure 5-3, the segments are logically combined 
under the name: MAIN_SEG. 

In this example source listing, all references are made via symbolic names; there are 
no absolute references in the source file. 


Module 1 

Module 2 

MAIN_SEG GROUP A SEG.B SEG 

MAIN SEG GROUP C SEG 

A_SEG SEGMENT 

C SEG SEGMENf 

ASSUME CS:MAIN_SEG 

ASSUME CS:MAIN_SEG 

A_SEG ENDS 

C_SEG ENDS 

B_SEG SEGMENT 


ASSUME CS:MAIN_SEG 


B_SEG ENDS 



Figure 5-3 The GROUP Pseudo-op 


.RADIX 


Format: .RADIX expression 


.RADIX allows you to specify a new default numbering base. The assembler’s 
standard default is base 10, or decimal. Since the assembler normally uses base 10 as 
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the default base, constants entered in binary, octal, or hexadecimal must use a 
suffix character to denote the numbering base of the operand. 

Example: 

MOV «X,0FFFFH |'H» for hexadacimal 

MOV 0L,277Q j'Q’ Octal 

MOV AL, 001100016 j'B’ for binary 

By using the .RADIX directive, the default numbering base is changed and subse¬ 
quent entries in that base will not require the qualifying base suffix character. 


Example: 


.RADIX IB 

;Change to hex 

MOV ftX,0FFFF 

;DATA IS IN HEXADECIMAL 

.RADIX ^ 

;CHANGE TO BINARY 

MOV AL,00110011 

;DATA IS IN BINARY. 

jcimi# 

Format: END [expression] 


The END directive specifies the end of your source module. If you use an 
expression in the operand field, then the assembler uses the expression as the 
starting address of the program. Do not use an expression if the module is not the 
main program module. Figure 5-4 illustrates the use of END in the main module and 
a subordinate module. 

In Figure 5-4, notice that only the main module requires the END pseudo-op with a 
label. The label (START) defines the entry point of the program, where program 
execution begins after MS-DOS loads the program. Subordinate modules require 
the END pseudo-op only, without a label. 



Often during program development you’re faced with the problem of how to 
assemble one portion of code if a certain condition is true and another if the 
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In the main module; 


MY CODE 

SEGMENT 

START: 

PUSH DS 

MY.CODE 

ENDS 

END START 

In a subordinate moduie; 

MORE CODE 

SEGMENT 

START_MORE: 

MOV CX,AX 

MORE_CODE 

ENDS 

END 


Figure 5-4 Use of the END pseudo-op 


condition is not satisfied. Conditional pseudo-ops give you this flexibility. A 
common misunderstanding among novice programmers is that these statements 
are run-time conditionals, that they apply to an assembled program when it is run 
on the target machine. Conditional directives do not influence the manner in 
which the program executes, but only what portions of code are assembled at the 
time of assembly. 

Table 5-3 lists the conditional pseudo-ops available to the programmer using the 
IBM Macro Assembler. The conditional pseudo-ops test for a condition to be true or 
false. 

You can set the condition at the beginning of the module by using the = directive. 
For example: 

COMP_TYPE_ft ■ 1 
COMP_TYPE_B = 1 
COMP_TYPE_C - e 

can be used to set conditions for the assembly of different portions of code for one 
of three different computer types: A, B, or C. You can then use the conditional 
directives to assemble the correct portions of code: 


IFE COMP_TYPE_ft 


;Assemble this code section if COMP_TYPE_ft « 0 
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ENDIF 

IFE COMP^TYPE.B 

|Then assemble this portion of code if COMP^TYPE^B * 0 


ENDIF 

IFE COMP.TYPE.C 

jThen assemble this portion of code if COMP_TYPE_C * 0 


ENDIF 


Table 5-3 

Conditional Pseudo-ops 

Pseudo-op 

Condition/Function 

IF expression 

True if expression is not 0 

IFB < argument > 

True if the argument is blank. 

IFE expression 

True if the expression is 0 

IFNB < argument < 

True if argument is not blank. 

IF1 

True if pass one. 

IF2 

True if pass two. 

IFIDN <argument1> <argument2> 

Trueif arg. 1 = arg. 2 

IFDEF symbol 

True if the symbol has been 
declared external by EXTRN 
pseudo-op. 

IFNDEF symbol 

True If symbol is not declared 
external via EXTRN pseudo¬ 
op, or if symbol is undefined. 

IFDIF <argument1 > <argument2> 

True if string arguments are 
different. 

ELSE 

Optional clause allows alter¬ 
nate code to be generated 
when the condition is not sat¬ 
isfied. Only one ELSE per IF 
allowed. 

ENDIF 

Conditional block terminator. 
Each IF must have an ENDIF. 
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The previous example illustrates how one or more portions of code will be 
assembled if the specified expression is true. In the preceding example, an 
expression is true if it is equal to zero (IFE conditional used). This condition is 
satisfied in the example for COMP_TYPE_C only. Types A and B are equal to one; 
therefore, the expressions are evaluated as being false. 

You can nest the conditional statements as in: 


IFE COMP_TYPE_ft 

{assemble this portion of code if true 


MOV AL,DftTft_BYTE 

IFE SERIftL^PORTl 
MOV DX,SER.P0RT1 
ELSE 

MOV DX,SER.P0RT_2 
END IF 
END IF 


{Get data to send. 

{Serial portl true? 

{If yes, then get port address 

{If it is not true then assemble 
{using second port address 

{Get port number 

{Closes inner conditional 

{Closes outer conditional. 


The use of the ELSE clause allows an alternate portion of code to be assembled if the 
preceding IF clause is not satisfied. Each nested conditional must include an ENDIF 
clause which closes the conditional block properly. 



The listing pseudo-ops allow you to control the manner in which various listings 
are output by the assembler. 

Table 5-4 depicts the listing pseudo-ops and their functions. For example, the 
.XLIST can be used to halt the listing of source and object code. To re-enable the 
listing, simply use the .LIST pseudo-op. 

Example: 

.XLIST {Suppress listing 

INCLUDE DOS.EQU {Include the DOS equate file 

{Enable the listing 


LIST 
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Here the listing is suppressed so as not to list the entire DOS.EQU file. It is not 
necessary that every module using the DOS equates also lists them. To do so would 
create redundancy in your documentation, as several module listings would con¬ 
tain the same source statements. 



Table 5-4 

Listing Pseudo-ops 

Pseudo-op 

Function 

.CREF 

Enable cross reference output. 

.XREF 

Disable cross reference output. 

.LALL 

List complete macro text. 

.SALL 

Suppress listing of macro text, and macro 
object code. 

.XALL 

List only source lines which generate 
object code. 

.LIST 

Enable listing output. 

.XLIST 

Disable listing output. 

%OUT text 

Display the text entry during an assem¬ 
bly. 

PAGE [length), (width) 

PAGE with no arguments = go to the top 
of the next page. With arguments, wiii set 
page iength and/or page width. 

SUBTTL text 

Specifies subtitle to be printed on the sec¬ 
ond line of every page of the iisting. 

TITLE text 

Specifies the title to be printed on the first 
line of every page of the listing. 

.LFCOND 

List conditional blocks which evaluate as 
false. 

.SFCOND 

Suppress the listing of conditional blocks 
which evaluate false. 

.TFCOND 

Toggles the control switch for iisting false 
conditionals. /X option will reverse the 
effect of the .TFCOND in a source file. 


%OUT- 

I Format: % OUT text 


The %OUT pseudo-op allows a message to be sent to the display during assembly. 
It is most often used when assembling a large source file, and you want to monitor 
the progress of the assembly. By using the %OUT directive you can tell when a 
portion of code is being assembled, or not being assembled, as is the case when the 
directive is used during a conditional assembly. 
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Example: 

IFE COMP_TYPE_fi jls asseinbly for type ft? 

*OUT Now assembling for TftNDY 8000 5 Then display comp, type 

•• ycrwc:. tor Other computer types 


ELSE 

IFE COMP^tYPE.B 

%0UT Now assembling for COMPAQ 


ELSE 

IFE COMP_TYPE_C 

%0UT Now assembling for the IBM PC 


ENDIF 
END IF 
ENDIF 


.XCR£F and .CREF 


Format: .XCREF 
.CREF 


These pseudo-ops suppress the cross-reference information (.XCREF) and enable 
the cross-reference listing (.CREF). If no cross reference listing has been specified, 
these pseudo-ops have no effect. 

.LALL, .SALE and .XALL —- 

These pseudo-ops control the manner in which macro expressions are listed. .LALL 
tells the assembler to list the entire macro text (including comments) during macro 
expansions. .SALL suppresses the listing of all text and object code produced by 
macro expansions, and .XALL permits only source lines that generate object code 
to be listed. Macros are discussed in Chapter 6. 
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.LFCOND, .SECOND and 

.TFCOND- 

This set of pseudo-ops controls the listing output of false conditional blocks. 
•LFCOND enables the listing of conditional blocks that are evaluated by the 
assembler as being false. .SFCOND suppresses the listing of conditional blocks that 
evaluate as false, and .TFCOND toggles the current setting for the listing of false 
conditional blocks. Pages 5-79 through 5-82 of the IBM Macro Assembler manual 
detail these directives. 


PAGE-- 

Format: PAGE [length] [width] __ 

The PAGE pseudo-op formats the listing file generated by the assembly. It can be 
used to force a top of page or to set the page’s length and the number of characters 
printed on a line. When no operands are specified with the PAGE directive, the 
printer performs a form feed to the next top of page. The page number is incre¬ 
mented by 1, and the listing continues. 

When operands are specified, they set the number of lines printed per page and the 
total number of characters printed per line. A special operand (-1-) increments the 
chapter number and sets the page number equal to one. The format of the page 
number printed at the top of each assembly listing is: 

PftGE CHftPTER # - PftBE # 


To increment the chapter number, use the -I- operand with the PAGE directive. 


Examples: 
PAGE SS,132 

PAGE 60,80 

PAGE 
PAGE + 


I Sets page length to 55 lines 
;and page width to 132 chars. 
;per line. 

;Sets page » 60 lines_page 
5 and 80 chars_line 

;So to the next page. 

;Inc. chapter number. 


TITLE 


Format: TITLE text 


TITLE defines the title of the listing and is listed on the first line of each page. If you 
do not use the NAME directive, as explained previously, the first six characters of 
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the title text are used as the module’s name. You can enter up to 60 characters in 
the text field. You can use only one TITLE pseudo-op per assembly. 

Example: 

TITLE Number base conversions. 

«»## SUBTTL «#«* 

Format I SUBTTL text 

The subtitle pseudo-op specifies a subtitle, which is printed on the line immedi¬ 
ately following the title. Unlike the TITLE directive, which is limited in use to once 
per assembly, the SUBTTL pseudo-op can be used as many times as necessary. 

Example: 

SUBTTL Version 1.1.S 



The IBM MACRO Assembler allows the use of operators within many of the source 
statements of a program. The operators alter the manner in which the statement is 
assembled. The operators can be classified as attribute, value returning, record 
specific, and those used to form arithmetic, logical, and relational expressions. The 
value-returning operators SEG, OFFSET, TYPE, SIZE, and LENGTH were discussed 
at the beginning of this chapter, as were the record specific operators SHIFT, 
MASK, and WIDTH. 


Attribute Operators 


Pointer, Segment, SHORT 
PTR- 

Format: newtype PTR exp 


The pointer operator overrides the type or distance of the label. I have already used 
this operator in previous programming examples to demonstrate how byte values 
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can be referenced in data fields that have been defined with another type attribute 
(word, double word, etc.)- For example: 

DECIMAL.TABLE DM leees,1000,100,10 

defines a table of decimal values with a TYPE attribute of word. By using a 
statement such as: 

MOV fiL,BYTE PTR DECIMftL_TftBLE 

you are able to access any single byte within the table. If you were to use a 
statement like: 

MOV RL,DECIMftL.TfiBLE 

an error message would be generated, since the TYPE attribute of the variable does 
not match the attribute being used in the source statement. Since AL is a byte-wide 
register, the DECIMAL_TABLE cannot be referenced without the use of the PTR 
operator. 

The LABEL pseudo-op and the operator THIS (discussed in a moment) can also be 
used to allow the mixing of data types in variable access. Some examples are: 

BYTE_DEFINE_TftBLE LPBEL BYTE 

DECIMAL.TPBEL DM 10000, 1000, 100, 10 

or 


BYTE_D£FINE_TPBLE EQU THIS BYTE 
DECIMfiL_T«BLE DM 10000,1000,100,10 


These would both allow the DECIMAL_TABLE to be accessed using byte-wide type 
instructions as in: 

MOV OL,BYTE_DEFINE_TftBLE 

The segment and offset attributes of DECIMAL_TABLE are assigned to 
BYTE_DEFINE_TABLE, while the TYPE attribute is changed from word to byte. 

Similarly, the distance attribute (NEAR or FAR) of a label can be modified by using 
the PTR operator: 

FftR_ENTRY EQU FOR PTR LfiBEL_ONE 


LABEL ONEI 


PUSH AX 


ISAVE ACCUMULATOR 
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This allows either intersegment or intrasegment calls and jumps to reference the 
same entry point. If the label FAR_ENTRY was not defined, only intrasegment code 
transfers could take place, as the label LABEL_ONE is assigned a NEAR distance 
attribute due to the colon suffix used in its label dehnition. 


THIS- 

Format: THIS attribute or type 


The THIS operator assigns to an operand the distance attribute (NEAR or FAR) at 
the current offset of the assembler’s location counter. It can also be used to assign 
an operand the current type and segment value designated by the location counter. 

Examples: 

BYTE_VftLUE EQU THIS BYTE ;assigns BYTE.VfiLUE 

type attribute of BYTE 

MY^TABLE DM 100 DUP(10) ;to access bytes in table 


PUBLIC 


CODE^ENTRY 


^Declare as public 


CODE.ENTRY EQU THIS FAR ;A1Ioms another segment 

gentry to this portion of 
;code. 


HIGH and LOW 


Format: op-code operandl 
HIGH operand2 
opcode operandl 
LOW operand2 


The HIGH and LOW operators allow you to isolate either the high or low bytes of a 
number or an address expression. This operator allows the mixing of data types. 
For example: 

WORD.Vfll- DM IBEBH 


and 

MOV ftH,HI0H WORD_V«L 


move the high order byte lOH into the AH register. These operators were provided 
to allow some degree of compatibility with the earlier Intel 8080 microprocessor. 
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Segment Override Operators 


DS, SS, ES- 

When I discussed the 8088 instruction set in the last chapter, I mentioned how 
certain registers are automatically associated with each of the segment registers. At 
times this can prove to be inconvenient. What if you want to use the contents of the 
BP register to access data in the current data segment rather than the stack segment 
BP is usually associated with? Fortunately, you are able to override this association 
and are able to use the index, pointer, and base registers to reference data in other 
segments. 

For example, assume BP contains 20H: 

MOV AX,DSIDECIMAL_TftBLE CBP3 

This moves the 32nd word entry contained in DS:DECIMAL_TABLE into AX. 
Other examples of segment override usage are: 


MOV 

CL,BYTE PTR ES:CSI3 

;get byte 
;ES8S1 

value 

from 

MOV 

PX,DSs CBP3 

9 get word 

value 

from DS:BP 


Distance Attribute 


SHORT- 

I Format: JMP SHORT target 


The SHORT attribute instructs the assembler to generate a 2-byte jump instruction 
rather than the normal 3-byte jump instruction. The program transfer address must 
be between +127 and -128 bytes from the jump instruction. This implies that the 
label attribute of the target operand is of the NEAR type. 

Example: 

JMP SHORT THPT^LPBEL ;MUST BE < <+) 127 BYTES 

;FORHPRD 

THAT^LPBEL: MOV CX,NEW_COUNT 5 
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Expressions: Relational, 
Logical, Arithmetic 


Relational Operators —. . 

EQ, NE, LT, LE, GT, GE- 

The relational operators test two operands and return a zero result if the com¬ 
parison is false and a word of all ones (OFFFFH) if the comparison is true. They are 
usually combined with a bit mask, giving you a means to manipulate an instruction 
(Table 5-5). 



Table 5-5 

Relational Operators 

Format 

Function 

argument-1 EQ argument-2 

True if argument-1 = argument-2 
(equals) 

argument-1 NE argument-2 

True if argument-1 <> argument-2 
(not equai) 

argument-1 LT argument-2 

True if argument-1 < argument-2 
(iess than) 

argument-1 GT argument-2 

True if argument-1 > argument-2 
(greater than) 

argument-1 LE argument-2 

True if argument-1 < argument-2 
or if 

argument-1 = argument-2 


For example, if the label VALUE is found to be equal to 10: 

OR nx,((VALUE EQ 10) AND 7) OR ((VALUE NE 10) AND S) 

it reduces to: 

OR AX,7 

and, if VALUE is not equal to 10, the statement is assembled as: 


OR 


AX, a 
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Logical Operators 

AND, OR, XOR, NOT-— 

I purposely used the 8088 OR instruction and a logical OR operator in the example 
above. The second OR is the logical operator and is evaluated at assembly time, 
whereas the first OR is the instruction generated by the assembler and is executed 
by the 8088 during program execution. 

Since the assembler contains the AND, OR, XOR, and NOT logical operators, it is 
important that you do not confuse them with the 8088 instructions of the same 
name. Although they perform the same logical functions, the operators are evalu¬ 
ated by the assembler, and the instructions are evaluated and executed by the 8088. 
This is a subtle but noteworthy distinction. 


Arithmetic Operators 

MOD, SHR, SHL, +, -, *, /- 

The arithmetic operators perform assembly time calculations on the specified 
operands. MOD divides one operand by another and returns the result. For exam¬ 
ple: 

VALUE1 EQU 10 

VALUES EQU 3 

MOV AX,VALUE1 MOO VALUES 

evaluates to; 

MOV ftX,1 

The SHR and SHL operators shift values either right or left a specified number of bit 
positions and operate in a manner similar to the shift instructions in the 8088’s 
repertoire. However, the logical instructions, which have the same names, should 
not be confused with the SHR and SHL operators. Remember that the operators are 
used by the assembler for calculating a value to be used in an instruction or pseudo¬ 
op. 

The remaining arithmetic operators perform the basic math functions of addition, 
subtraction, division, and multiplication. Some examples of their usage are: 


MOV 

AX,16«20 

;Moves 4S0 

into AX 


MOV 

AX,VALUE1/VALUE2 

;Moves the 
;into AX 

quotlent 

of the division 

MOV 

CX, TABLE_END-TABLE_.START 

;Number of 

bytes in 

the table 
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The instruction: 

MOV CX,SIZE TABLE 

also loads the CX register with the total number of bytes in the table. 

The order in which operators are evaluated in an expression is discussed in the IBM 
Macro Assembler manual on pages 4-20 and 4-21. 

In the next chapter I will discuss the Macro pseudo-ops and their usage. Included in 
the chapter is a complete Macro library for MS-DOS 2.0. The library is also included 
on diskette and should enable you to write progranis for the IBM PC and compati¬ 
bles in a more efficient and structured manner. 



1. ASSUME instructs the assembler which_registers to associate 

with each segment in the program. 

2. A procedure can either be of the_type or the_type. 

3. Match the pseudo-ops which define data for each type listed below. 


A. 

Ten Bytes 

F. 

DB 

B. 

Byte 

G. 

DT 

C. 

Double Word 

I. 

DQ 

D. 

Quad Word 

J. 

DW 

E. 

Word 

K. 

DD 


4. Which pseudo-op allows redefinition of a symbolic name with a value? 

A. EQU 

B. = 

5. To increment the chapter number of a listing use the_directive. 











Two very important concepts are discussed in this chapter, macros and the IBM 
operating system, PC-DOS/MS-DOS. I’ve taken the liberty of combining the two 
subjects in one chapter for a good reason. Included in the chapter is a discussion of 
a program containing macros for all of the MS-DOS and many of the BIOS calls used 
by the IBM. By using these predefined macros, your programming time and 
productivity will be increased. Because the macro definitions invoke MS-DOS 
function calls, this chapter seemed to be a logical place to discuss both. 

By the end of this chapter, you will know what macros are, how to create your own 
macro definitions, and how to use them. You’ll also understand the manner in 
which MS-DOS manages the resources in your IBM PC. After reading the first part 
of this chapter, which explains macro definitions, you should reread the macro 
listing pseudo-ops discussed in Chapter 5. 



Macros allow you to assign a series of often used source statements to a macro 
name, and then reference the entire sequence by specifying the macro name in the 
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op-code field of a source statement. As an example, let’s say you need to repeatedly 
use the following instruction sequence: 

PUSH PX 
PUSH BX 
PUSH CX 
PUSH DX 
PUSHF 


You would normally code the entire sequence every time it is need in a program. 
By assigning the sequence to a macro definition, the instructions are defined once, 
and the macro name is used to generate the instruction sequence. You define a 
macro in the following manner: 


SAVE^PLL.RESS MACRO 
PUSH AX 
PUSH BX 
PUSH CX 
PUSH DX 
PUSHF 
ENDM 


;Macro definition header 
;Body of the macro 
9 I 
9 I 
9 i 
9 \ / 

;ENDM is the macro terminator 


The macro is assigned the name SAVE_ALL_REGS by the macro pseudo-op. The 
ENDM pseudo-op terminates the macro. Anytime you need to save all the registers 
in your program, use the macro name SAVE_ALL_REGS in the op-code field of an 
assembly language statement. Figure 6-1 demonstrates how this macro and a macro 
definition that restores all the registers can be used in a program. 


Dummy Arguments 


Optional dummy arguments can also be specified in the macro definition, as 
depicted in Figure 6-2. 

Notice in Figure 6-2 that the assembler places a plus sign to the left of any source 
statements that appear as a result of the expansion. 

This particular macro defines a routine that places a string of characters typed from 
the keyboard in a predefined buffer area. The dummy argument KBDBUFFER is 
replaced by the name of the keyboard buffer used in the program. If your program 







Macros and MS-DOS 171 


defines a buffer area in the data segment and you name this buffer MY_KEYS, you 
would invoke the macro by specifying the macro name and the buffer name as 
follows: 

I»KBL.1NE MY.KEYS 


SAVE ALL REGS 

MACRO 

;Macro header 

PUSH AX 
PUSH BX 
PUSH CX 
PUSH DX 
PUSH SI 
PUSH Dl 
PUSH DS 
PUSH ES 


;Bodyofthe macro 

SAVE_ALL_REGS 

ENDM 

;Macro terminator 

GET ALL REGS 
POPES 
POPDS 
POPDI 

POP SI 
POPDX 
POPCX 
POPBX 

POP AX 

MACRO 


GET ALL REGS 

ENDM 



Figure 6-1 Example Macro Usage 


Define the macro: 

©KBDLINE MACRO KBDBUFFER 
MOV AH,F_KBDLINE 

LEA DX,KBDBUFFER 

INT MSDOS 

ENDM 

;MSDOS function OAH 
;Address of user buffer 
;Msdos type 21H interrupt 
;End of macro 

Invoke the macro in the source program: 

©KBDLINE 

MY.KEYS 


At assembly time the assembler expands the macro as: 

@KBDLINE 
+ MOV 
+ LEA 
-1- INT 

MY KEYS 

AH,F KBDLINE 
DX,MY_KEYS 

MSDOS 

;MSDOS function OAH 
;Address of user buffer 
;Msdos type 21H interrupt 


Figure 6-2 Macros which contain dummy arguments 
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The assembler expands the macro definition above by substituting the statements 
which comprise the macro. The statements are inserted in the assembly at the point 
where the macro definition is encountered. The real buffer name replaces the 
dummy argument (KBDBUFFER) in the expansion. You can use more than one 
dummy argument in a macro definition by separating each argument by a comma as 
shown in Figure 6-3. 


Define the macro: 


@SET_INT VECTOR MACRO TYPE,SEG_VECTOR,OFFSET_VECTOR 

PUSH 

DS 

;Save old data segment 

MOV 

AX,SEG_VECTOR 

;Segment of new interrupt vector 

MOV 

DS,AX 

;Place in DS 

MOV 

DX,OFFSET_VECTOR 

;Offset of the service routine 

MOV 

ALJYPE 

;The MSDOS type number of the interrupt 
:vector to change 

MOV 

AH,F_SET_INT_VECTOR 

;MSDOS function 25H to set new 
;interrupt vector 

INT 

MSDOS 

iMSDOS interrupt 21H 

POP 

ENDM 

DS 

; Restore old data segment 

Invoke the 

macro: 


@SETJNT_VECTOR MACRO OCH,MY_CODE,RSJNT_1 


Figure 6-3 Macros with multiple arguments 


Figure 6-3 shows how multiple dummy arguments are passed to a macro. Simply 
separate each with a comma. You may optionally not specify one or more of the 
parameters when you invoke the macro; in which case, the value for that param¬ 
eter is set to zero (null value). In the example shown, a macro is defined which, 
when invoked, changes the interrupt vector for the specified interrupt type. The 
type number specified is OCH, which happens to be the routine for the serial I/O 
board of the IBM PC. 

Macros extend the capabilities of the assembler by allowing you to define your own 
op-codes for often used instruction sequences. Don’t confuse macro definitions 
with procedures. Macros generate in-line code (by macro expansion) every time 
the macro is invoked. Procedures define a set of instructions which, when 
assembled, reside in only one portion of memory and are called when needed. 

Macros are used when the instructions are few in number, yet often used, or when 
calling a procedure would cause an unacceptable delay in processing speed, the 
processor has to push and pop the instruction pointer and perhaps the code 
segment register from the stack. 

Since one macro statement can be used in place of several instructions, source 
programs that use macros are more readable and shorter in length. The object 
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module is usually longer, due to the in-line code produced by the macro expan¬ 
sions. 

Macro definitions are usually defined in a separate source file, thereby creating a 
library of definitions. The file is included in the assembly via the INCLUDE 
directive, as shown in Figure 6-4. 


Page 60,132 

TITLE ANY_PROGRAM 

SUBTTL USE_OF_MACROJNCLUDE 

.XLIST 

INCLUDE B:DOSEQU.EQU 
.LIST 

IF1 

INCLUDE B:MACFLE.MAC 
ENDIF 


Figure 6-4 


Notice that the INCLUDE directive, which specifies the macro library, appears 
within a conditional assembly block. The IFl pseudo-op includes the macro library 
on the first pass of the assembler but not on the second pass. The file must be 
included on the first pass, so that the assembler can resolve any macro definitions 
referenced in the program. However, the IFl pseudo-op prevents the macro library 
from being read on the second assembler pass, which generates any listings that 
have been specified. Therefore, the macro library does not appear in the listing file. 

You might wonder why this is such a big deal. The reason is quite simple. Assume 
that you have created a program comprised of multiple modules. Each module 
utilizes macro definitions as defined in the macro library MACFLE.MAC (Listing 6-1 
in Appendix D). As each module is assembled separately, the library file would be 
included in every module’s listing! Needless to say, you need to list the macro 
library only once (as a source file), not every time an assembly listing is generated. 


Local Labels 


Labels used in a macro definition must be declared local to the macro, by using the 
LOCAL pseudo-op. LOCAL informs the assembler that the label is part of a macro 
definition and, as such, the label should be changed each time the macro is 
invoked. The reason the label must be altered is that the assembler requires that a 
label be defined only once in a source program. 
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Consider the following source statements: 
0INPORT MftCRO 

HERE8 IN AL,DX 
CMP PL,IBH 
JNE HERE 
ENDM 
0INPORT 
0INPORT 


i INPUT CHAR- FROM P PORT 
9ESC CHPRPCTER? 

;NO? THEN LOOP 


; Invoke a macro for port input 
;Do it again. 


When expanded, the macros produce the following code: 


HERE8 IN PL,DX 
CMP PL,IBH 
JNE HERE 
HERE8 IN PL,DX 
CMP PL,IBH 
JNE HERE 


5 INPUT CHPR. FORM P PORT 
•ESC CHPRPCTER? 

;NO?, THEN LOOP 
;INPUT CHPR. FROM P PORT 
;ESC CHPRPCTER? 

INO? THEN LOOP 


What do you think the assembler will do? Obviously, the assembler will not be able 
to distinguish which label HERE the program should branch to. In this case, the 
assembler generates an error message to inform you that it has encountered a 
symbol with multiple definitions—HERE. 


Since macros are usually used more than once in a program, any labels appearing 
within the body of the macro must be declared local to it. Failure to declare them 
local causes the assembler to generate an error message. LOCAL must be used 
immediately after the macro statement. It must be used before any other statements 
in the macro, including comments. Figure 6-5 illustrates the use of the LOCAL 
pseudo-op. 


@SET C CHECK 

MACRO SWITCH1,SWITCH2 

LOCAL 

FETCH 


MOV 

AL.SWITCHI 

;Set or fetch control C kbd 

OR 

AL 

;Checking. Z means fetch state 

JZ 

FETCH 


MOV 

DL,SWITCH2 

;Set the state 

FETCH: 



MOV 

AH,F SET C CHECK 

;MSDOS function 33H 

INT 

MSDOS 

:lnterrupt21H 

ENDM 




Figure 6-5 Use of the LOCAL pseudo-op 
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When expanded, the assembler generates a unique label in place of the label 
specified as LOCAL (FETCH, in this example). This prevents a multiply-defined 
symbol error message from being generated on repeated macro expansions. 


Other Macro Pseudo-ops 


Other macro pseudo-ops facilitate the definition of macros. Table 6-1 lists the 
macro pseudo-ops available with the IBM Macro Assembler. Additionally, any of 
the conditional pseudo-ops discussed in Chapter 5 may also be used in the body of a 
macro definition. I’ll discuss some macros that use conditional pseudo-ops later in 
this chapter. 


Table 6-1 

Macro pseudo-op definitions 

Pseudo-op 

Function 

name MACRO dummylist 

Macro header. Optional arguments may be specified 
in the dummylist. A macro name must always be 
specified. 

ENDM 

Macro terminator. Ends macro definition. 

EXITM 

When encountered, the macro expansion terminates 
immediately. 

LOCAL dummylist 

When encountered, the assembler will create a 
unique name for each occurrence of any argument 
listed as a dummy parameter. 

REPT expression 

When encountered by the assembler, any statements 
between REPT and ENDM are repeated by the 
number of times specified in the expression field. 

PURGE macro-name 

Deletes the specified macro from the assembly, 
allowing the memory the definition occupied to be 
reused. 

IRP dummy, < argument-list > 

Specifies a number of elements (argument-list), 
which are to be substituted for each occurrence of the 
dummy parameter within the block. (See text for a 
more complete definition). 

IRPC dummy .string 

Specifies a number of characters which are to be 
substituted for each occurrence of the dummy param¬ 
eter within the biock. 

Code produced by macro expansions. 

Object code in the expansion. 


continued 
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Table 6-1 

Macro pseudo-op definitions 

Macro Operators 

Function 

text&text 

Concatenates text or symbols in the macro expan¬ 
sion. 

;;text 

Inhibits the iisting of a comment foliowing the double 
semi-cpion. 

Icharacter 

The character following the exclamation point is 
entered literally in the expansion. 

% expression 

Converts the expression to a number using the cur¬ 
rent radix. 


PURGE- 

I Format: PURGE macroname[,....] 


The PURGE pseudo-op deletes the specified macro definitions from the assembly. 
The assembler deallocates the memory space it has reserved for the macro defini¬ 
tion. Once a macro has been purged, the memory space it occupied can be used by 
the assembler for other storage requirements. 

If you purge a macro from the assembly and then reuse the macro definition, the 
assembler generates an error message. You can use PURGE to delete macros that 
are never used in a program module, or you can use the directive to delete a macro 
if it will not be used again in the source module. 

KEPT- 

Format: KEPT expression __ 

The REPT pseudo-op causes the statements appearing between REPT and ENDM to 
be repeated the specified number of times. 

Example: 

TfiBLE_GEN M^CRO INITlyUORDS 5 Macro name and parameters 

NUMBER » INITl jSet initiral value 

REPT NORDS ;Parameter specifies # of repeats 

SQUPRE « NUMBER#NUMBER 5 Generate the square 

5 Increment to next number to square. 


NUMBER s NUMBER-f^l 
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DM SQUARE ;Define word in memory 

ENDM ;End repeat block. 

ENDM ;End Macro 

This macro produces a table of squares. The macro is invoked by specifying the 
macro name along with the parameters INITl and WORDS. INITl is the initial value 
for the first number to square, and WORDS is the total number of squares to 
generate (also the number of word entries in the table). The macro is invoked as 
follows: 

TfiBLE_SEN 1, 10 |6.rt.rate a 10-.ntry table of squares 

(beginning with 1. 


The table will contain the following values: 1, 4, 9,16, 25, 36, 49, 64, 81, and 100. 

You can also use the REPT and ENDM pseudo-ops outside of a macro dehnition. 
This provides an easy means of duplicating source statements. 

IRP- 

Format: IRP dummy, 

< argument list > 


The IRP pseudo-op causes each successive entry in the argument list to be sub¬ 
stituted for the dummy parameter. Let’s say you want to define the table of squares, 
as was done in the previous example, but this time using the IRP pseudo-op. The 
table could be generated as follows: 

IRP SQ_VflL, <1,4,9, 16,25, 36,49,64,81, 100> 

DW SQ.VftL 
ENDM 


Each value in the argument list is substituted for the symbol SQ_VAL, creating a 10- 
entry table of squares. 

IRPC- 


Format: IRPC dummy,string 


This pseudo-op lets you define ASCII character strings in memory. It is similar to 
the other repeat pseudo-ops, in that it causes a repetition of the block of statements 
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appearing between the IRPC and ENDM directives. The pseudo-op can be used in a 
macro definition or on its own (as can the other repetition pseudo-ops), as follows: 


IRPC 

MESSneE, Help! 

5 Character string » 'Help!* 

DB 

MESSAGE 

|One byte for each byte in the 

ENDM 


;message. 


The sequence above causes the following ASCII codes in the word Help! to be 
stored in memory as 48H, 65H, 6CH, 70H, and 21H. 

EXITM- 


Format: EXITM 


The EXITM pseudo-op causes the immediate termination of a macro expansion by 
the assembler. It is used after a conditional pseudo-op within the macro, which 
causes the assembler to encounter the EXITM pseudo-op and terminate the expan¬ 
sion. Figure 6-6 illustrates the use of the EXITM pseudo-op. 


@MY MACRO MACRO 
IFETRUE 

XCHG AX, BX 

;Swap AX and BX if condition is true 

EXITM 

;Then exit 

ENDIF 

XCHG AX,CX 

;Else if the condition is false, 

;swap AX and CX 

ENDM 

To force the condition in a source program: 

TRUE = 0 

iSet true to 0 

@MY_MACRO 

+ XCHG AX,BX 

;Swap AX and BX if condition is true 


Figure 6*6 Use of the EXITM pseudo-op 


In the example shown above, EXITM is used within a conditional block. If the label 
of TRUE is evaluated to be zero by the assembler, the portion of code residing in the 
conditional block is assembled ^CHG AS,BX). Since we set TRUE equal to zero 
prior to invoking the macro, the conditional block, which includes the EXITM 
pseudo-op, is assembled. When the assembler encounters the EXITM pseudo-op, 
the macro expansion is terminated as if the ENDM directive had been encountered. 
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Macro Operators 


Several operators enable you to construct complex macro definitions. Just as the 
operators used in source statements modify the instructions generated by the 
assembler, the operators used in a macro definition affect the manner in which the 
assembler expands the macro. 

& - 

Format: & expression _ 

The ampersand (&) operator concatenates text or symbols found in the macro 
definition. It can be used to dynamically define instructions, registers, or even 
labels within a macro. 

CLS MftCRO REG,COND,LINES 

CLS&REGs MOV ft&REG,“ACOND" 

MOV BX,LINES 
ENDM 

If the macro were to be invoked as: 

CLS H,Z,£4 ; 

it would be expanded as: 

CLSH: MOV AH,“Z” 

MOV BX,24 

In this example, a register was defined by the parameter REG, the ASCII character Z 
was defined by the parameter of COND, and the value to be moved into the BX 
register was defined by the parameter LINES. 

Another operator suppresses the expansion of a comment. When the assembler 
encounters a double semicolon (;;), the comment that follows is not expanded 
during assembly. 

Example: 


;;This line will not be part of the expansion. 
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% - 

Format: % Expression 

The percent operator (%) converts the specified expression to a number. The 
number returned will be in the current radix. Use of the percent operator is limited 
to macro arguments, as illustrated below: 

fl_MftCRQ MftCRO PfiRfiMETER_l ;Define the macro. 

DB PARAMETER,. 1 ;Define byte storage. 

ENDM ;End of the macro. 


Once the macro is defined, invoke it and use the % operator to specify the 
parameter, as follows: 


X = 10 
VALUE * 0 
REPT X 

VALUE = VALUE+1 

A^MACRO %VALUE 

ENDM 


;NUMBER OF TIMES TO REPEAT MACRO 
;SYMBOL DEFINED FOR PARAMETER 
5 REPEAT THE NEXT STATEMENTS "X» TIMES 
5 INCREMENT VALUE 
5 INVOKE MACRO, CONVERT VALUE TO 
;A NUMBER IN CURREi^T RADIX 
5 END OF REPEAT 


The above section of code invokes the macro definition A_MACRO ten times. 
VALUE is substituted for the dummy argument PARAMETER_1 each time 
A_MACRO is invoked. Since the label VALUE is assigned a numeric value that is 
incremented prior to each macro invocation, the sequence of instructions pro¬ 
duces a 10-byte table of OlH through OAH. 



The operating system (OS) of the IBM PC is an advanced and powerful operating 
system. The combination of the PC’s hardware design and its operating system 
opened up a new world to personal computer users, programmers, and third-party 
hardware suppliers. The operating system was originally developed by the Seattle 
Computer Company and sold to Microsoft, which continually improves upon the 
OS, with the latest version (at this writing) being MS-DOS version 2.10. 
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Operating Systems 


An operating system is the software that manages the resources of the computer 
(hardware). It is responsible for the management of I/O devices, including the 
video display, disk drives, and other functions, such as memory allocation. 

The system is also responsible for the user interface, the manner in which the user 
of the system receives and requests services from the OS. Utility programs that 
perform specific device functions are considered to be an adjunct of the operating 
system. These programs usually perform such functions as formatting a diskette, 
copying one file to another, and so on. MS-DOS contains similar utilities and a 
command-line user interface, in which you type a command line from the key¬ 
board that is actually a request for a system resource or service. 

Aside from the user interface level, which allows you to converse with the operat¬ 
ing system, MS-DOS has standardized the method of access to the functional calls 
within the operating system. These routines provide you with easy access to most 
of the major operating system functions necessary to write application programs. 
If you write your programs in such a manner that they interface to the hardware of 
the IBM (disk drives, etc.) through MS-DOS function calls, you can be assured that 
the programs will run on other MS-DOS computers with little if any modification. 

This is the major advantage inherent to MS-DOS, device independence. Device 
independence means that you do not have to concern yourself with the physical 
aspects of the hardware for a given machine. It does not matter to you if the printer 
port for the computer is at port 03C0H or at 0030H. You need only know that by 
using the appropriate MS-DOS function call, the character in the register will be 
sent to the printer if one is attached to the system. 

MS-DOS accepts user requested function calls and links those requests to lower 
level functions that are machine specific. The function calls requested are linked to 
BIOS, the Basic Input/Output System of the IBM PC. BIOS is responsible for the 
actual hardware interface of a given machine. 

Although this description is greatly simplified as to how MS-DOS and BIOS inter¬ 
act, it illustrates the fact that the BIOS implementation may be slightly different 
from one compatible computer to the next. However, MS-DOS has been standard¬ 
ized in such a manner that you are somewhat isolated from the hardware dif¬ 
ferences. 

The following discussion details the functional calls found in MS-DOS and their 
usage. The information describing these calls in IBM’s DOS Technical Reference 
Manual is minimal at best and is not well suited to novice programmers. 

All of the functional calls in MS-DOS lend themselves nicely to being defined as 
macros. Listings 6-1 and 6-2 (see Appendix D) define the MS-DOS macro calls used 
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to invoke MS-DOS function calls. Before looking at the programs, let’s look at the 
mechanism through which MS-DOS manages the IBM PC’s resources. 


Function Calls 


When I discussed the 8088’s instruction set in Chapter 4, I described the INT 
instruction as a shorthand method of calling a procedure. When the 8088 encoun¬ 
ters the INT instruction, the current contents of the IP and CS registers are saved on 
the stack, and the registers are then loaded with new values that send program 
execution to the appropriate interrupt service routine. 

The IBM operating system, PC/MS-DOS, uses interrupt types 20H - 27H. MS-DOS 
uses interrupt type 21H almost exclusively for executing function calls. MS-DOS 
expects that certain registers contain certain values, or addresses, when the type 
21H interrupt routine is encountered. Specifically, AH is used as the messenger to 
inform the operating system of the function being requested. 

The function specified might be to read a key from the keyboard into a buffer, 
display a character, or to write a sector of information to disk. MS-DOS interprets 
the value in AH as a function code and executes a specific function based upon this 
value. 

Other registers and, for some function calls, memory areas must be initialized prior 
to using the function calls. For example, most disk functions require that a Disk 
Transfer Area (DTA) or a file control block be established in memory and that the 
DX register point (contain the base address) to these areas. Other registers may be 
required for other specific purposes. Each function call uses the registers of the 
8088 in a slightly different manner and for slightly different purposes. 

The minimal format for executing an MS-DOS system call is: 

MOV ftH,FUNCTION_CODE jSet function code 

INT MSDOS jEXECUTE DOS INTERRUPT TYPE glH 


where FUNCTION_CODE is the MS-DOS function request number, (read from 
keyboard, display a character, etc.) and the label MSDOS is equated to 21H, the MS- 
DOS interrupt type number for function requests. 

If the instruction sequence depicted in the preceding example is used often within 
a program, it would save you a considerable amount of time if only one source 
statement had to be typed, as opposed to the two shown above. By defining the 
instruction sequence as a macro name, only the macro name needs to be entered 
into the source file where the instruction is required, as follows: 
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©WAITKEY 

MACRO 


MOV 

AH,F^WAITKEY 

;FUNCTION REQUEST 

I NT 

MSDOS 

5 DOS CALL 

ENOM 




Now the instruction sequence is assigned to the macro name @WAITKEY. The 
instruction sequence is generated (or expanded) in the assembled version of the 
program wherever the assembler encounters @ WAITKEY. 

In the example above, the symbol F_WAITKEY is used in place of the absolute 
value for the function. The label MSDOS is similarly defined elswhere in the file to 
have the value 21H; the value for the MS-DOS function call interrupt type. I have 
defined ail such MS-DOS calls as macros in MACFLE.MAC and included them in 
Listing 6-1 in Appendix D. 

DOSEQU.EQU, the other file of interest, is shown in Listing 6-2 in Appendix D. 
This file is the DOS equate file, which contains all of the equates used for the 
function code numbers under MS-DOS 2.10. If you use the files DOSEQU.EQU and 
MACFLE.MAC in your program modules, you must use the INCLUDE pseudo-op to 
read them into your assembly as follows: 

.XLIST 

INCLUDE DOSEQU.EQU 

. LIST 

IFl 

INCLUDE MfiCFLE.FLE {Include macro file on pass 1 only. 

ENDIF ;End of conditional block. 

The DOS equate file must be read on both passes of the assembler or a phase error 
will result. Phase errors occur when the assembler finds a different value for a label, 
variable, or procedure on the second pass than it found during the first pass. 

.XLIST and .LIST inhibit the listing of the equate file for the same reason IFl and 
ENDIF are used to inhibit the macro file from being included in the listing. The 
difference between using the .XLIST/.LIST and IFl/ENDIF directives is that the 
assembler reads the DOSEQU.EQU file on both passes but reads the MACFLE.MAC 
file only during the first assembler pass. In either case, it is not necessary to include 
these files in the listing file, unless you happen to own your own paper mill and are 
not concerned with wasting paper when you print out the listing file. 

You’ll notice in Listing 6-1 that the labels BIOS and MSDOS are equated at the 
beginning of the macro file. I don’t believe that Microsoft will ever change the 
interrupt type number for the function calls, but in keeping with earlier discussions 
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of defining labels, a label is assigned the numeric value for the BIOS interrupt type 
and the most often used MS-DOS interrupt type. Should they change, simply 
change the interrupt type number assigned to the label to the new value. You won’t 
have to edit any of the macros if the interrupt type is redefined. 

Each macro in Listing 6-1 is commented as to the MS-DOS function invoked and any 
other special considerations you should be aware of. Look at the macro that defines 
function code OlH in Listing 6-1. The function waits for a key to be pressed at the 
keyboard and moves the character typed at the keyboard into the AL register. The 
character is also echoed to the display. 

Other than preparing the AH register with the function code OlH, prior to execut¬ 
ing the INT 21H instruction, no other special preparations are necessary. After 
executing the function, the user program would then process the character 
returned in AL. 


Minimal Programming 
Considerations 

Many of the MS-DOS function calls expect dedicated areas to be established in 
memory prior to issuing a function call. Within these dedicated areas there may be 
several bytes or words that you must initialize to certain values prior to invoking 
the MS-DOS function. 

When using the character oriented keyboard functions, OlH, 06H, 07H, and OSH, 
you don’t need to have a special RAM area established, as the character is returned 
in AL. However, there are two methods available to obtain a line of keyboard input. 
You can either repeatedly use one of the single character function calls and build 
the string in a buffer area or use the MS-DOS function call OAH, which waits for a 
line of input to be entered from the keyboard. 

If the latter function is chosen, a buffer area must be defined in the data segment as 
follows (Note: You can use any valid names for the labels shown, but the reserved 
memory must remain the same): 


MftX^CHftRS: 

DB 

(?) 

SMaximum characters allowed. 

CHftRS^TYPED 

DB 

(?) 

;Number of characters typed. 

KBDBUFF 

DB 

32 

$The actual buffer must be as 


I large as the maximum chars 
;specified in WfiX_CHftRS. 

;It can be larger or smaller 
;than the value used in this 
;example. 

The buffer area consists of a defined byte which communicates to the function 
OAH, the maximum number of bytes you expect to be entered from the keyboard. If 
you exceed the specified number of characters when entering the input line, the 
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function produces a tone at the speaker (beep) and won’t accept any further input 
except for a carriage return (which must terminate the input line). 

On entering the function, DS:DX must point to the beginning of the buffer area 
MAX_CHARS. You can use LEA DX,MAX_CHARS to load DX with the address 
pointer before invoking the function. The maximum number of characters the 
function is to return must be specified in MAX_CHARS prior to calling the function. 
The maximum count must include the carriage return as the terminator to the 
string. If the anticipated input is four characters as in GARY, then set MAX_CHARS 
to 5. Four characters and the carriage return will then be accepted by the function. 

On return, the number of characters actually typed from the keyboard will be in the 
memory location CHARS_TYPED. You can use this information as a count factor 
to move the data from the keyboard buffer to another buffer if you like (See the 
MOVS instruction). 

Listing 6-3 in Appendix D contains a short program that accepts a line of input from 
the keyboard and displays what was typed. Notice the creation of the necessary 
keyboard buffer area KBD_BUFFER at the beginning of the data segment. Notice 
also that the $ terminator is defined in memory at the label DELIMITER. I’ll discuss 
why I used the delimiter in a moment when the display routines are discussed. The 
program uses macro definitions found in the macro file, MACFLE.MAC, and the 
function codes are part of the equate file, DOSEQU.EQU. 



The example program KEYDSP in Listing 6-3 uses the following macro calls: 


ecLS 

-> 

Clears the display. 

eCHPRDSP 

-> 

Displays the character in DL 

©VDLINE 

-> 

Display a line of text pointed to by 

DS:DXy and terminated by Hi. 

@C0N_lNPUT2 

-> 

Wait for a character to be typed at the keyboard 
return it in PL. 

©KBDLINE 

-> 

Get a line of input from the keyboard. 

©CRLF 

-> 

New line function, generates a carriage 
return, linefeed, places the video cursor 
on the 1st column, next line. 

©WAITKEY 


Waits for a key to be entered from the keyboard 
and echoes the character to the display. 
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The program prompts you for keyboard input, accepts what you type from the 
keyboard, and displays it. The program then asks you to press any key to continue 
and repeats the entire program. To terminate the program, type Control-C from 
the keyboard, and the program ends, returning you to DOS. 

Review the macro definitions in the MACFLE.MAC listing for the keyboard func¬ 
tions OlH, 06H, 07H, OSH, OAH, OBH, OCH. All of these functions can be used to 
retrieve a character from the keyboard. The difference between the functions is 
that some automatically echo the keyboard character to the display while others do 
not. Some functions (such as OlH) will not return until a character is entered from 
the keyboard. Other functions recognize the Control-C character while others do 
not check for the control character. Each function is summarized in the MAC¬ 
FLE.MAC listing. 


The Stack Segment 


The stack segment is established as 100 words (200 bytes), which is more than 
enough for this program. If the program were more complex, the stack may have to 
be allocated more memory. 


The Data Segment 


The data segment contains all the necessary buffers and messages used in the 
program. The segment contains the keyboard buffer area already discussed and all 
of the messages used to converse with the user. The delimiter $, is required by the 
MS-DOS function call 09H, which displays a line of ASCII text pointed to by DX. 
The delimiter terminates the text to be displayed and, when encountered during 
the line display function, terminates the function and returns control to your 
program. The terminator is also required for the MS-DOS function 09H. 


The Code Segment 

The code segment for the program in Listing 6-3 contains instructions to make the 
program perform the desired task; it accepts and displays input from the keyboard. 
The program logic is shown in Figure 6-7. 

The source program in Listing 6-3 is comprised of mainly macro statements. It is 
comparable to viewing a program which was written in a high level language, in 
that the macro names describe a function and not necessarily the instructions 
which comprise the function itself. 
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Figures-? Flow Chart for KEYDSP.ASM 


If you wanted to, you could define a macro language that could appear as if it were 
a high level language. The only disadvantage is that the instructions comprising a 
macro definition are expanded as in-line code every time a macro is encountered. 
This is not a very efficient use of memory and is not a recommended programming 
habit. 

When repetitive instruction sequences produce more than a few bytes of code, it is 
better to code the sequence as a procedure and not define the sequence as a macro 
definition. This results in a reduction of executable code produced by the 
assembler. 
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The instructions that comprise the body of each macro are present in the assembled 
listing of the program. They immediately follow the macro name. The assembler 
places a + in column 31 of the listing, indicating that the current line was generated 
due to a macro expansion. 

Rather than explain each of the DOS functions in detail, I’ll explain how to use the 
functions in programming examples. The macro definitions have many comments 
and require little explanation here. You should examine the macro definitions in 
detail before experimenting with their usage. I will explain dedicated RAM buffers 
or areas that must be established prior to using the functions. The explanations 
appear in the programming examples as they are presented. 

You are now ready to earn your wings as an Assembly Language programmer. In 
Chapter 7 I’ll show you a complete programming example from start to finish, 
from conceptual design to actual implementation. So “Kick the tire and light the 
fire,’’ let’s GO! 



1. Macro definitions assign a_of often used_to a 

macro name. 

2. A macro is composed of a_, a_, and a_. 

3. ENDM_the macro definition. 

4. To invoke a macro, use the_. 

5. The LOCAL pseudo-op assigns a_name to a label each time the 

macro is invoked. 

6. The minimal format for executing a MS-DOS function call is: (Write in the 
form below) 


7. Why do MS-DOS function calls lend themselves to macro definitions? 












NUMBERSY.ASM, the program discussed in this chapter is like the others I have 
presented, in that the program is capable of standing on its own. It is completely 
interactive with the user and illustrates many of the principles that I have discussed 
so far. (See Listing 7-1 in Appendix D.) 

For those who are still trying to comprehend how decimal, binary, and hex¬ 
adecimal relate to each other, this program should answer your questions. The 
program converts numbers between 0 and 65,536 from one base to another. 


I’ll discuss the program from its beginning premise to its ending statement. This 
program should serve as an example for defining, implementing, and documenting 
your future programs. 



This program allows you to enter a number in one of three number bases, decimal, 
binary, or hexadecimal, and the computer translates the number to the other two 
bases and displays it in each of the numbering systems. This type of program 
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illustrates the usefulness of the computer in performing repetitive and error-prone 
calculations. 

If you recall the discussion of numbering systems and conversions from one base to 
another in Chapter 1, there were many repetitive steps involved in the translation 
from one number base to another. Why not let the computer handle the conver¬ 
sion? Simply choose the number base you want to convert from (decimal, binary, 
or hexadecimal), enter the number, and let the computer perform the conversions 
to the remaining numbering systems. 

The program performs the following: 

1. Accept a number in; 

A. Decimal, and convert the number to hexadecimal and binary. 

B. Hexadecimal, and convert the number to binary and decimal. 

C. Binary, and convert the number to decimal and hexadecimal. 

2. Display the conversions. 

3. Asks you if you want to repeat the program and perform another conversion. 

4. ' If yes, go to step 1; else exit the program and return to MS-DOS. 



One of the first things you should do is sketch out the program using a flow chart or 
write down the programming steps. Both methods are shown in Figure 7-1. A flow 
chart or some other written form of the program’s flow helps break the program 
down into its modular components. Each module performs a specific function and, 
as such, allows others to better understand the program and allows easier modifica¬ 
tion of the program if necessary. 

The program must translate numbers entered in decimal and hexadecimal form to 
binary. The binary number must then be converted to the remaining number base. 
Similarly, the program converts numbers entered in binary to decimal and hex¬ 
adecimal. 

It is not enough that you are able to conceive of the algorithm, or steps required to 
satisfy the application, and perform the conversion. In this program, as in others 
you will write, the modules that support the application must be present and a part 
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Save return address 
and offset. Establish 
DS and ES use. 


Clear the screen 


Display the prompts 
for the user’s choice. 


Get response from user. 

Was the response valid? 
Continue if yes. 


Was it decimal to 
binary and hexadecimal? 


Was it binary to decimal 
and hexadecimal? 


Must be hexadecimal to 
decimal and binary? 



Run the program again. 


Is the carry set? 

If so. then repeat the 
program. 

Else end the program. 


Figure 7-1 Flow Chart for NUMBERSY.ASM 
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of the program. An interactive user interface must be defined that will display 
messages and accept user input. Error-handling routines, or error trapping within 
the program modules must be specified to insure that all data entered are valid. 

Other commonly used subroutines or procedures must be defined as well. Routines 
that clear the screen, perform bounds checking, and other functions must also be 
part of the program. 

The macros used in this program are in the MACFLE.MAC listing (Listing 6-1 in 
Appendix D). The macros shorten program development time and make the source 
program more readable. 



As illustrated in previous programming examples, there must be at least one stack 
segment and one code segment in every program you write. It is not necessary for 
every module within the program to use its own stack segment, but there must be a 
minimum of one stack segment defined in the program. Naturally, somewhere in 
one or more modules, a code segment (or segments) must be defined. Without the 
code segment, there would be no executable code produced. 

In NUMBERSY.ASM, the stack, data, and code segments are titled MY_STACK, 
MY_DATA, and MY_CODE, respectively. I will discuss each of the segments as 
they pertain to the program. 


Data Sclent (MY,DATA) 

The data segment reserves storage for a keyboard buffer (KBD_BUFFER) that is 
used to accept a line of input as entered from the keyboard. The buffer area is 
established to conform to the requirements of the MS-DOS function call OAH. The 
function expects the maximum number of characters that will be entered to be 
specified in the first byte (byte 0) of the keyboard buffer. This byte is labeled in the 
program’s data segment as MAX_CHARS. 

The function accepts a line of input that is terminated by a carriage return. If the 
number of characters entered exceeds the number specified by the contents of 
MAX_CHARS, the routine rejects the character and produces a beep tone through 
the internal speaker. The MS-DOS function OAH stores the actual number of 
characters entered in the second byte of the buffer (CHARS_TYPED). The data 
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entered from the keyboard begins with the third byte of the buffer (KBD_BUFFER 
+ 2) and ends with a maximum of KBD_BUFFER + MAX_CHARS. Therefore, it is 
necessary to define a buffer large enough to hold the maximum number of charac¬ 
ters that will be accepted as a line of input from the keyboard. 

Notice that MAX_CHARS is initialized to 32. This is done only because it is the 
maximum number of characters allowed in the buffer K_BUFF. When the line input 
function is needed in the program, MAX_CHARS should be set to the number equal 
to the maximu m number of characters anticipated. In other words, you can 
dynamically change the number of characters that are to be entered from the 
keyboard prior to using the function. You are not limited to the value MAX_CHARS 
is initialized to. The only requirement is that the maximum number of characters 
specified does not exceed the total buffer’s length. 

The function number OAH is moved to the AH register and the effective address of 
the keyboard buffer (KBD_BUFFER, in this example) to DX. The macro 
©KBDLINE accomplishs the register setup prior to invoking the function. Simply 
invoke the macro as follows: 

OKBDLINE KBD_BUFFER 

The parameter specified in the invocation is the buffer where the keyboard input is 
to be stored. MAX_CHARS must be set up prior to invoking the macro. 

Messages — ■■ 

Most programs contain a number of messages that define a portion of the user 
interface to the program. Messages are used to prompt you when input is required, 
to confirm previous input from the user, and to display error messages. In an era of 
“user friendly’ ’ programming, the more messages used, the easier the program will 
be for others to understand and make use of. 

The message area for the program NUMBER_SY.ASM defines the messages4ieces- 
sary to obtain user input in the program. Each message is terminated by 24H ($). 
You may recall from previous programming examples that the terminator is 
required by the MS-DOS function 09H. If the terminator is not present, the func¬ 
tion continues to display whatever characters or data it encounters until the 
terminator is found. MESSAGE_0 through MESSAGE_9 are the messages used in 
NUMBERSY.ASM. 

Storage Allocation 

When performing the conversions from one number base to another, certain 
memory locations are set aside to hold or accumulate results. When a number to be 
converted is entered from the keyboard, each character is ASCII encoded. For 
example, the string 35678, as entered from the keyboard, is in its ASCII equivalent 
form: 33H, 35H, 36H, 37H, 38H. Although the number can be contained in two 
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bytes in binary form, some type of storage must be allocated for the number 35678 
when it is represented in ASCII. In this example, 5 bytes of storage must be 
allocated for the value. 

The storage locations that have been defined to hold the ASCII characters entered 
from the keyboard are: 

HEXADECIMAL - will store 4 ASCII digits entered in hexadecimal 
format <0-9, A-F) 5 

BINARY^ASCII — will store 16 ASCII digits entered in binary 
format (1 or 0 ); 

DECIMAL - will store 5 digits entered in decimal format < 0-9 ). 

The word location BINARY stores the data which has been converted from ASCII 
to true binary form. The first operation performed by any of the three conversion 
routines is to convert the ASCII data entered from the keyboard to a true l6-bit 
binary representation. The result of this conversion is stored in BINARY. 

Defining Tables . 

Two tables have been defined in the data segment: DECIMAL_POWERS, and 
HEXADECIMAL_POWERS. These tables define the powers for each digit position 
for the particular number base. For example the number 35678 is actually: 

Digit 5 » 3 x 10 to the fourth power « 30000 
Digit 4 * 5 X 10 to the third power * 5000 
Digit 3 as 6 X 10 to the second power » &00 

Digit 2 =a 7 X 10 to the first power « 70 

Digit 1 « 8 X 10 to the zero power * 8 


The sum of each digit’s value results in the total magnitude of the number. The 
algorithms I chose for the conversion routines decompose decimal and hex¬ 
adecimal numbers in this manner. 

Equates and 
Other Definitions ■— 

Aside from the usual inclusion of the DOS and BIOS equate file (DOSEQU.EQU) at 
the beginning of the source file, the labels ONE, FOUR, FIVE, SIX, and SPACE are 
equated to their ASCII equivalent values. They are used in the only macro defined 
directly within the program. 
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The DISP_PROMPTS macro displays up to three messages and two numbers. It was 
defined to allow you an easy method of displaying a message in a predefined 
format. Specifically, it is used to prompt the user for the number to be converted. 
As each type of conversion requires a different number of digits to be entered, the 
macro formats the display in the following manner: 

Message1 -> Messages -> Number1 -> Numbers -> Messages. 


By invoking the macro in a manner similar to: 

@01SP_PROMPTS MESSASE.1,MESSAQE_4,ME8SfiBE_5,FIVE, SPACE 

the following prompt appears on the video display: 


I Entar tha dacimal valua you want to convart: I 

I Entar 5 digital I 


You’ll find the messages MESSAGE_1, MESSAGE_4, and MESSAGE_5 defined in the 
data segment. 

By using the macro, a prompt can be created for any of the number conversions the 
program is to perform. In the example just cited, the program is prompting you for 
a 5-digit decimal number which will be converted to binary and hexadecimal. As 
this macro is somewhat specialized and dedicated to this application, it is not 
included in the macro file MAGFLE.MAC in Listing 6-1. 


Code Segment MY CODE 


Initialization '' 

The program begins with the usual setup of the data and extra segment registers. 
After the standard program preamble, NUMBERSY. ASM begins at the program label 
START_HERE. 

The program begins by clearing the screen and prompting you for the type of 
conversion. Respond by entering the type of conversion desired. If the entry is 
valid, the program branches to the appropriate routine to perform the conversion. 
Should you enter a nonexistent choice, the program traps the entry error and asks 
the question again. The symbolic label INIT marks the beginning of the program; it 
initializes the data and extra segment registers. 

The screen is cleared by moving a count of 24 into the CX register and repeatedly 
executing a carriage return/linefeed combination until the CX register is 0. This 
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effectively clears the screen. The only disadvantage to clearing the screen in a 
manner such as this is that the cursor remains positioned at the first column of the 
24th line on the CRT (bottom left corner). I’ll demonstrate a better way to clear the 
screen and position the cursor in later chapters. 

Next, the MS-DOS function to display a line of ASCII text is invoked to prompt you 
for the type of conversion desired. The macro @VDLINE, when expanded, 
invokes the MS-DOS function 09H. The parameter supplied to the macro must be 
an ASCII message which is defined in the data segment and terminated with 24H 
($). 

Program Label: 

RESPONSE- 

Once the prompts are displayed on the screen, you must enter a 1, 2, or 3. 
Remember that the data returned from the keyboard using the MS-DOS keyboard 
functions is in ASCII form and may not be in the form required by the program. The 
macro ©WAITKEY invokes the MS-DOS function OIH; it waits for a key to be 
pressed, and echoes the character back to the display. The character typed will be 
in register AL after the function returns from MS-DOS. 

After receiving the character typed at the keyboard, a linefeed and carriage return 
is executed, which moves the cursor to the start of the next line. By moving the 
cursor to the next line, the display remains neatly formatted. It is quite easy to 
forget these little necessities when programming. But remember if your program 
does not look nice to the user or it is difficult to use, you’ll find yourself writing 
programs that can only be used by one person—you! 

I always try to write programs (even ones that only I will use) as if they were 
commercial programs or routines I had purchased for myself. I find I am also my 
own worst critic. Therefore, the program must not only be aesthetically pleasing, 
but it must perform exactly as intended. If you write your programs in a similar 
manner and judge them as if you had purchased them from another party, you’ll 
write solid programs that can be used by almost anybody. 

The value entered from the keyboard is in the AX register and is temporarily saved 
on the stack prior to executing the carriage return/linefeed combination. The value 
is restored (popped) after the newline function is executed. Since the macro 
@LFCR destroys the contents of the AL register, the register must be saved before 
using the macro. 

The program executes one of three possible routines, based on your entry. You 
could have the program simply compare the value that was entered to its ASCII 
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counterpart to determine which routine to execute. However, I’ve used another 
and more efficient way to accomplish a branch in the program. Let’s say you type a 
3 from the keyboard. First, the high order bits are masked by logically ANDing the 
AL register with OFH. The effect of masking the high order digits is then: 

ValuB in AL - >>> 00110011 (ASCII 3 > 33H) 

AND with 0FH->>> 0 0 0 0 1 1 1 1 

Result —>>>- 0000001 1 (Binary 3) 

What has actually happened is that the value in AL has been converted to a binary 
value. This technique for ASCII to binary conversion works for single digit numeric 
entries in the range of 0 to 9. When there is more than one digit to convert or the 
data entered is not a numeric digit, other techniques must be employed—I’ll 
discuss those in a moment. 

The next few statements following the label RESPONSE determine which conver¬ 
sion routine is required. Register AL is decremented by one, using the DEC instruc¬ 
tion. If the remaining value is zero, program control is transferred to the 
appropriate routine. The program restarts if the value in AL is greater than 3 (an 
invalid user response). 

NUMBERSY.ASM does not check to see if the character typed by the user was a 1, 2, 
or 3 . You could have entered A, B, or C (4lH, 42H or 43H), in which case the value 
obtained by the ma.sking of the high order bits would also have produced a binary 
value in AL of 1, 2, or 3. 

In other programs the user’s response may have to be limited to a certain range or 
to specific characters. The more error trapping included in a program, the more 
foolproof the program will be. 

This leads to one of my laws about programming: You can make programs 
foolproof but not idiot proof. There will always be someone who can find the one 
weak link in a program. If there is not a weak link in the program, then the true 
“idiot” will spill coffee on program disk! The way around this is to act as your own 
“idiot” tester. Do everything except spill coffee on the disk. Enter invalid data and 
see how your program traps the errors. Have one of your friends or neighbors run 
the program. Test every routine and every module in the program. Use the 
debugging facility of MS-DOS to single step through a procedure. Set up the 
registers and data areas with test data that can be checked for erroneous results. 
Once you’ve put the program through the acid test of self-examination and exten¬ 
sive testing, your product is ready to be released. 
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I will now discuss the program logic for the first choice presented to the user: 
decimal to binary and hexadecimal conversion. The other conversion routines 
follow similar logic and can be followed by using the flow charts in Figure 7-1 or by 
inspecting Listing 7-1 Appendix D. As each procedure is discussed, you should look 
up the procedure in the listing and follow the the source code along with the 
discussion. 


Decimal to Binary and 
Hexadecimal Conversion 


If you answer the initial prompt for a decimal to binary and hexadecimal conver¬ 
sion, the program branches to the label BIN_DEC_HEX_1, which in turn calls the 
procedure to accept a decimal number from the keyboard. 


Procedure: 

DEC_BIN_HEX- 

This procedure prompts you for the decimal number to be converted, translates 
the number to the other numbering systems, and displays the conversions. The 
procedure begins by setting the MAX_CHARS memory location to 6. This allows 
you to use the MS-DOS function to accept a line of input from the keyboard. As 
mentioned earlier, the line input must be terminated by a carriage return. There¬ 
fore, the maximum number of characters is set to 6: 5 for the decimal number and 1 
for the carriage return. 

Program Label: 

- 

Once you have entered the 5-digit decimal number, the string is moved from the 
keyboard buffer K_BUFF to the storage location DECIMAL. Registers SI and DI 
establish the source and destination address pointers required for the MOVSB 
instruction. MOVSB moves a byte of data from the location pointed to by DS:SI to 
the memory location pointed to by ES:DL As ES and DS are set to point to the base 
of the same segment (data segment), MOVSB moves bytes from one part of the 
segment (K_BUFF) to another (DECIMAL). 









Number Conversions: A Programming Example 199 


Notice that a count of 5 is moved into the CX register, which enables the MOVSB to 
be repeated using the REP prefix. Each time the instruction is executed, the CX 
register is decremented by 1. If the CX register does not contain zero, the instruc¬ 
tion is repeated. The net result of the operation is that the first 5 digits are moved 
from [SI] to [DI). 

Program Label: 

D_B_H_2- 

A call is made to the procedure DECIMAL_BINARY, which performs the necessary 
decimal to binary conversion. Another call is then made to the procedure BIN- 
ARY_HEXADECIMAL, which converts the l6-bit binary value stored at BINARY to 
a 4-digit ASCII encoded hexadecimal value. 

Program Label: 

Once the value has been converted to binary and hexadecimal, the results of the 
conversions must be displayed. Since the storage locations DECIMAL, BIN- 
ARY_ASCII, and HEXADECIMAL are terminated by 24H ($), the macro @VDLINE 
can be used to display their contents on the video display. The procedure 
DISP_ASCII_BINARY displays a binary value on the screen. The procedure 
DEC_BIN_HEX then returns to the main program at the statement following the 
DEC_BIN_HEX1 label. 

The program again branches, this time to the label DONE_IT_2, which calls two 
more procedures, FLUSH_BUFFERS and ANOTHER_ONE. FLUSH_BUFFERS clears 
the keyboard buffer K_BUFF and the RAM locations BINARY, BINARY_ASCII, 
HEXADECIMAL, and DECIMAL. The buffers are cleared to insure a known state, 
should the program be repeated. A common mistake in programming is neglecting 
to reinitialize a data area before it is reused. For the most part, this does not create a 
problem. In a few instances it can. It is always better to be safe than sorry, so 
remember to reset buffers, storage locations, and pointers after they have been 
used and are no longer of importance. 

The procedure ANOTHER_ONE simply asks if you want to run the program again 
and perform another conversion. If you enter an affirmative response, the pro¬ 
cedure returns to the calling program with the carry bit set in the flag register. If 
you enter a negative response, the routine returns with the carry bit reset, and the 
program terminates. 
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Decimal to 
Binary Conversion 


Procedure: 

DECIMAL.BINARY- 

The procedure DECIMAL_BINARY expects a 5-digit ASCII string to be stored in 
RAM starting at the label DECIMAL. The routine further expects that each digit is an 
ASCII value between 30H and 39H,or 0-9. It would make little sense for a decimal 
number to contain anything but 0-9, yet the routine does not check for the digit’s 
validity. This would be an excellent opportunity for you to write a bounds- 
checking routine that would parse the string stored at DECIMAL for proper values. 

The routine fetches an ASCII digit from memory, masks the high order bits, and 
multiplies the binary number 0-9 by the decimal power for the digit’s position. 
This was demonstrated earlier in this chapter. The result is then added to the RAM 
location BINARY. The process is repeated for all five ASCII decimal digits. 

The algorithm is implemented as follows: SI and DI are used as pointers to the 
decimal ASCII string entered by the user and the table DECIMAL_POWERS, respec¬ 
tively. SI and DI are set to zero via the XOR statement, and the RAM location 
BINARY is set to zero. BINARY must be cleared at the beginning of the conversion 
routine, as it is used to accumulate the result of the decimal to binary conversion. 

A value of 5 is moved into the CX register, which defines the number of times the 
conversion loop CONV_BIN is executed—once for each decimal digit. 

The value stored at DECIMAL -I- (SI) is moved to the AL register. The ASCII digit is 
stripped to its binary equivalent and multiplied by the decimal power pointed to by 
DI. The result is then added to the storage location BINARY. SI and DI are then 
adjusted to point to the next decimal entry and the next decimal power. Notice that 
DI must be incremented twice, since the decimal powers are stored as word (2- 
byte) values. The loop is then repeated for the next digit. When all 5 digits have 
been converted, the routine returns to the calling procedure. 
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Hexadecimal to 
Binary Conversion 


Procedure: 

HEX_BIN_DEC- 

This procedure converts a 4-digit hexadecimal number stored at HEXADECIMAL 
to its binary equivalent. It is similar to the decimal to binary conversion routine. 
The exception is that when a hexadecimal digit in the range of A to F is entered 
from the keyboard, the digit is represented in ASCII as 4lH to 46H. Simply masking 
the high order bits will not convert the ASCII digit to binary, as it will for the ASCII 
digits 0-9. 

What must be done is to first determine if the value is greater than or equal to 4lH. If 
not, the entry is assumed to be in the range of 31H-39H, which is 0 - 9, and it does 
not require any special consideration when converting the value to binary. 

If the digit is equal to or greater than 4lH, the digit entered is assumed to be in the 
range of A - F. The procedure handles this special case with the programming 
statements found at the label MULT_HEX. To convert the digit to binary, subtract 7 
from the digit’s value and mask the high order bits. For example: 


Digit to converts 41H 

* 'ft’ 

« 0100 

0001 

(Binary) 



- 0000 

0111 


suDvrecTr / ————————— 


(Binary) “• “■ 

Result - 

-> 

0011 

1010 

(Binary) 

Mask high order bitss 

ftND 

0000 

1111 

(Binary mask) 

Result - 

-> 

0000 

1010 

(Binary) 


The value has now been correctly converted from base 16 (hex) to base 2 (binary). 
The next step is to multiply the value by the hexadecimal power for that digit’s 
position in the string. If the digit is the most significant digit, the value is multiplied 
by 4096. The binary product is accumulated in the location BINARY. The HEX- 
ADECIMAL_POWERS table contains the powers for each hex digit’s position. 

BX and SI are adjusted to point to the next hex digit and the next hexadecimal 
power. The loop MULT_HEX is then repeated for all four hexadecimal digits. 
When all the numbers have been converted, the procedure returns to the calling 
routine. 

The conversion assumes that the hexadecimal number which has been entered is 4 
digits and in the range of 0 to F. There is no error-checking routine to test whether 
or not each digit is actually in this range. A good practice exercise for you would be 
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to write a routine that would check for a valid entry. If the character entered is out 
of range, have the program branch to an error handler routine which would 
display an error message and ask the user to reenter the data. Hint; The routine, 
CHECK_BOUNDS, which is part of the program DIRREAD.ASM discussed in Chap¬ 
ter 8, will perform what is required. 


ASCII To Binary Conversion 


Procedure: 

ASCII_BINARY_CONV- 

When the type of conversion selected is binary to decimal and hexadecimal, the 
data entered will be a l6-byte ASCII string of ones and zeros representing a l6-bit 
binary value. The procedure’s documentation contains the algorithm used in the 
conversion and is listed in Listing 7-1. 

Binary to Decimal Conversion 


Procedure: 

BINARY.DECIMAL- 

Once a binary value is obtained by using any of the three binary conversion 
procedures just discussed, a conversion can be made to any of the remaining 
number bases. So the first step in any of the conversion procedures is to convert the 
ASCII values to binary, and then convert the binary value to the other number 
bases. If this were not done, specialty routines would have to be written to convert 
decimal to hexadecimal, and hexadecimal to decimal. 

The algorithm used to convert a binary number to a decimal string begins by 
dividing the binary value by the higher decimal power, converting the result in AL 
to an ASCII digit, and storing the digit. Any remainder is recovered and the next 
highest decimal power is divided into the remaining binary value. The process is 
repeated until a 5-character ASCII string is built in the RAM storage location 
DECIMAL. 

The procedure begins by clearing the 5-byte storage location at the label DECIMAL 
in the data segment. A space character (ASCII 20H) is stored in each of the 5 bytes. 
Next, DI and SI are set to zero and used as pointers to the DECIMAL storage area and 
the DECIMAL_POWERS table, respectively. 
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The binary value is moved from memory (BINARY) to AX. The DX register is 
cleared to accommodate the DIV instruction, which divides the decimal power 
pointed to by SI into the value contained in AX. The quotient in AL (actually AX) is 
then logically ORed with 30H to yield a displayable ASCII character. The contents 
of register AL are stored in the DECIMAL string area at the byte pointed to by DI. 

The pointers are adjusted to point to the next storage location for the next decimal 
digit and to the next decimal power. The remainder from a division is stored in DX 
following the DIV instruction. Therefore, the remainder in DX is placed in AX via 
the XCHG instruction, and the loop MAIN_CONV is repeated until all five decimal 
digits have been constructed. The result is a 5-digit ASCII string that represents the 
decimal value of the binary word stored at BINARY. 


Binary to 
Hexadecimal Conversion 


Procedure: 

BINARY.HEXADECIMAL- 

The algorithm used to convert binary numbers to hexadecimal is a little more 
involved than the binary to decimal routine. The l6-bit binary number must be 
converted to 4 hexadecimal digits. The following example illustrates the conver¬ 
sion process: 


Assume the binary word to convert is: 

01 101 10100001010 (Binary) 

1) Take the high order byte of the binary word: 
01101101 

A) Mask the low order nibble of the byte; 

01 100000 (60 hex) 

B) Shift the high order nibble left four bit positions 
to the low order nibble. 

000001 10 

C> If the value is greater than or equal to 0AH 
add 37H to the value; otherwise, logically OR 
30H with the byte. 

The value is less than 0AH, so we OR 30H with the value. 
0 0 110 110 (3&H » ASCII '&M 


continued 
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D> Store the ftSCII-Hex digit. 

E) Retrieve the first byte of the binary word. 

0 110 110 1 

F) Mask the high order nibble of the word. 
00001 101 

G) Repeat step l.C for this value. 

Since the value in our example is greater than 
0AH, we must add 37H to the value. 

0000 11 0 1 

4-001 101 1 1 

01000100 (44 hex) 

The value is now an PSCIl D, which is the value 
of the low order nibble of the first byte in 
hexadecimal. 

H) Store the result in the next storage location. 

2) Take the low order byte of the binary word. 

00001010 

A) Repeat steps l.A - l.H above for this byte value. 


In this case, the algorithm is so close to the actual code used in its implementation 
that I will not discuss each instruction in the routine. Rather, I direct your attention 
to the procedure as illustrated in Listing 7-1 in Appendix D. 


Displaying 
ASCII-Binary Values 


Procedure: 

DISP_ASCII_BINARY- 

This procedure displays a binary value stored in the RAM location BINARY. Each 
bit of the binary word is rotated right 1 bit position via the ROR instruction. By 
using the ROR instruction, the bit rotated out of the MSB (bit 15) is copied into the 
carry. This information can be used by a conditional jump instruction. If the bit is 
0, the carry is clear. If the bit is 1, the carry is set. The conditional jump instruction 
allows branching to the portion of the program that places the proper ASCII 
character (1 or 0) in the l6-byte buffer beginning at label BINARY_ASCII in the data 
segment. 
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In each case, the program must display the ASCII equivalent character for that 
particular bit position (31H for a 1 bit and 30H for a zero bit). 

Displaying the String ." ■ 

Once the string has been built in the RAM locations BINARY_ASCII[01 through 
BINARY_ASCII[15], the program displays each character one at a time with a space 
character (20H) between the digits. The space is inserted between the ASCII digits 
to make the video display easier to read. 


In Conclusion 


The number conversion algorithms are useful general purpose routines that can be 
incorporated in other programs. For example, it is sometimes convenient to 
display the register contents of the 8088 when debugging a program. The binary to 
hexadecimal routine could be altered to perform such a function. Code conver¬ 
sions (such as ASCII to Baudot) and number conversions are some of the most 
common routines found in programs. These routines and the documentation 
found in the source program discussed in this chapter should enable you to begin 
working on more elaborate programs. 







One of the most fascinating and intimidating programming chores for novice 
programmers is writing programs that read from and write to disk. It really isn’t 
difficult to write your own routines utilizing disk I/O, especially when you use the 
function calls supplied by MS-DOS. Any function accessed via the INT 21H inter¬ 
rupt, can be found in the listing of MACFLE.MAC discussed in Chapter 6 (see Listing 
6-1, Appendix D). Each function is well-documented in the listing; therefore, the 
conventions used in register setup, error reporting, and so on, are not repeated. 
Consult the MACFLE.MAC listing for the details on the functions used. The disk 
functions supported by MS-DOS interrupt type 21H are summarized in Table 8-1. 
Those marked by an asterisk are found only under version 2.0. 


Table 8-1 

MSDOS Disk Functions 

Used with INT 21H 

Function Number 

Function 

ODH 

Disk Reset 

OEH 

Select Disk 

OFH 

Open a File 

10H 

Close a file 

11H 

Search Directory for a file. 

12H 

Search Directory for the next matching 


entry. 

13H 

Delete the specified file from the directory. 

14H 

Sequential record read. 
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Table 8-1 

MSDOS Disk Functions 

Used with INT 21H 

Function Number 

Function 

15H 

Sequential record write. 

16H 

Create a file. 

17H 

Rename a file. 

19H 

Fetch the current disk number. 

1AH 

Set the disk transfer address. 

1BH 

Get the FAT byte for version 1 .x disk (See 
function 36H) 

21H 

Random record read. 

22H 

Random record write. 

23H 

Get the file size. 

24H 

Set the random record field (bytes 33-36) in 
the specified FCB. 

27H 

Block read. 

28H 

Block write. 

29H 

Parse a string for a filename. 

2EH 

Verify after disk write. 

2FH* 

Fetch the address of the current DTA. 

30H* 

Fetch the current MSDOS version number. 

36H * 

Read the free space available on the spec¬ 
ified drive. 

39H* 

Create a sub-directory. 

3AH * 

Remove a directory entry. 

3BH* 

Change the current directory. 

3CH* 

Create a file. 

3DH* 

Open a file. 

3EH* 

Close a file. 

3FH* 

Read characters from a file or device. 

40H* 

Write characters to a file or device. 

41H*. 

Delete a directory entry. 

42H* 

Move address pointer of file. 

43H* 

Read or change a file’s attributes. 

45H* 

Duplicate a file handle. 

46H* 

Point a file handle to a new file. 

47H* 

Read current directory path. 

4BH* 

Load and execute a program. 

4CH* 

Terminate current process and close any 
open files. 

4EH* 

Find matching pathname with the attributes 
specified. 

4FH* 

Find the next matching pathname with the 
attributes specified. 

54H* 

Fetch the status of the verify flag (verify/write 
flag). 

56H* 

Rename a file. 

57H* 

Get or set the date time stamp of the spec¬ 
ified file. 
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Before I discuss the routines that access files and the directory using MS-DOS, I 
want to discuss the structure of the diskette itself. It is important to understand the 
physical layout of the diskette when using the more advanced disk I/O program¬ 
ming techniques. 



The diskette is a digital recording medium that can be thought of as a circular piece 
of magnetic recording tape. The medium stores magnetic flux reversals, which 
correspond to a 1 or 0 bit of data. The diskette is divided into tracks, sectors, and 
clusters. There are 40 tracks on a diskette, as formatted with the IBM PC. Other MS- 
DOS machines use disk drives capable of formatting 80 tracks on a diskette. 

Figure 8-1 illustrates the layout of a diskette. The outermost track is track 0 and the 
innermost track is track 39. Track and sector numbering always begins with zero 
rather than one. Each track is divided into either 8 (MS-DOS 1.x) or 9 sectors per 
track. (MS-DOS 2.0). You can also read and write 8 sectors per track under MS-DOS 
2.0, allowing you to read and write version 1.x formats. Each sector is capable of 
storing 512 bytes of data. 



Figure 8-1 
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Disk Drive Differences 


To confuse matters more, not all drives are the same. Some disk drives contain only 
one read and write head and are referred to as single sided disk drives. When the 
drive contains two read and write heads, it is referred to as a double sided drive. 
Single sided disk drives are capable of reading and writing information on one side 
of the diskette, while a double sided drive can store twice as much information, as 
both sides of the diskette can be written to. 

Single Density versus 
Double Density 


Another issue is the recording technique employed to encode data on the diskette. 
When a technique called Frequency Modulation, or FM, is employed, the recording 
technique is referred to as a single density recording format. When MFM, or 
Modified Frequency Modulation, is used as the data encoding technique, it is 
referred to as a double density recording technique. The recording format is 
determined by the disk controller and not the disk drive, as most drives being 
manufactured today are capable of recording in either single or double density. 
The issue is not a major one from an application programmer’s standpoint, yet the 
difference is important from the standpoint of understanding how the diskette is 
organized. Like the single sided versus double sided issue, double density record¬ 
ing of data allows twice the data storage of single density recording. All drive types 
used with the IBM PC record data using the MFM recording format (double 
density). 

To calculate the total storage capacity of a 5 1/4-inch diskette as formatted under 
MS-DOS, you need to know whether the drive is single or double sided, the total 
number of tracks available, and whether there are 8 or 9 sectors per track. Table 8-2 
summarizes the formatted storage capacities for the different types of IBM disk 
formats. 

Clusters —" ' . 

IBM PC-DOS/MS-DOS introduces a concept known as a cluster; this is either one 
sector for single sided diskettes or two adjacent sectors for double sided diskettes. 
The use of clusters in referring to sector numbers in a file is a result of trying to 
minimize read and write head movement during disk access. 

For single sided MS-DOS version 1.x and 2.0 diskettes, the sectors are numbered 
from 0 to 319 . Single sided disks are allocated 1 sector per cluster. For MS-DOS 2.0 
double sided diskettes, the sectors are numbered from 0 to 7, starting with head 0, 
0 track 0, and from 8 to 15, starting with head 1, track 0. The IBM Disk Operating 
Manual states that all available sectors are used before moving on to the next track. 
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Table 8-2 

Diskette Capacities 

Data Capacity in bytes Single Sided 8 Sectors per Track; 

Version 1.0 Version 1.1 Version 2.0 

160,256 (SS8ST) 160,256 (SS8ST) 160,256 (SS8ST) 

147,968 * 146,434 * 119,296 * 

Data Capacity in bytes: Double Sided 8 Sectors per Track: 

Version 1.1 Version 2.0 

322,560 bytes 322,560 bytes 

308,736 bytes 282,600 bytes * 

Data Capacity in bytes: 9 Sectors per Track 
Version 2.0 Only. 

Single Sided Double Sided 

179,712 bytes 362,496 bytes 

138,752 bytes * 321,536 bytes * 

'Capacity when diskette is formatted with the Is option which writes the IBMBIO.COM, 
IBMDOS.COM, and COMMAND.COM files to the disk. See the disk map in Table 8-3. 


Therefore, data are written to or read from disk using the lower numbered head 
first (head 0) for all sectors (0-7). Then all sector numbers (8-15) are used for the 
same track using the other head (head 1). Once the total number of sectors allocated 
to a track has been utilized, the head advances to the next track. For double sided 
disks, two consecutive sectors are allocated to each cluster. 

MS-DOS version 1.1 double sided sector numbers begin with head 0, track 0, sectors 
0-7. Unlike the 2.0 format, head 1, track 0 begins its numbering at sector number 
320. Sector numbers are allocated sequentially on the first side of the disk from 
track 0, head 0, sector 0 through track 39, head 0, sector 319. Then the sector 
numbers continue sequentially from the opposite side of the disk from track 0, 
head 1, track 320 to track 39, head 1, sector 639. 

MS-DOS maps the cluster allocation via the file allocation table (FAT). The clusters 
inform MS-DOS what clusters have been allocated to a given file. Page 4-10 in the 
IBM DOS Technical Reference Manual contains the information needed to con¬ 
vert clusters to actual sector numbers for a file. Most applications do not require an 
in-depth knowledge of clusters and file allocation space. It does become important 
if for some reason you need to directly access a sector for a file. 

Table 8-3 illustrates the numbering sequence for sectors under MS-DOS 1.x and 2.0 
for the various formats found in each version. The disk map in Table 8-3 also shows 
which sectors and tracks are allocated to specific system files. The files marked 
with an asterisk exist whenever you have formatted a new diskette using the 
system option (/s); otherwise, the sectors normally occupied by the files are 
available for user data. 
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Table 8-3 






MSDOS Disk Map 






Version 1.0/2.0/2.10 




Sinale-Sided 8 Sectors/Track 


Double Sided 8 Sectors/Track 


File Track 

Sectors 

File 

Track 

HD 

Sectors 

BOOT 

0 

0 

BOOT 

0 

0 

0 

FAT 

0 

1-2 

FAT 

0 

0 

1-2 

DIREC 

0 

3-6 

DIREC 

0 

0 

3-7 





0 

1 

320-321 

BIOS* 

0 

7 

BIOS* 

0 

1 

322-325 


1 

8-10 





MSDOS * 

1 

11-15 

MSDOS * 

0 

1 

326-327 


2 

16-23 


1 

0 

8-15 





1 

1 

328-330 

COMMAND * 

3 

24-31 

COMMAND * 

1 

1 

330-335 


4 

32-33 


2 

0 

16-20 

User files begin on; 







Track 4, Sector 34 



Track 2, Head 0, Sector 21 



And Continue Until: 







T rack 39, Sector 319 



T rack 39, Head 1, Sector 639 


*IBMBIO.COM, IBMDOS.COM, COMMAND.COM exist when the diskette is formatted 

with the /s option. 







Version 2.0 

Sinale Sided 9 Sectors/Track 


Double Sided 9 Sectors/Track 


File Track 

Sector 

File 

Track 

Head 

Sector 

BOOT 

0 

0 

BOOT 

0 

0 

0 

FAT 

0 

1-4 

FAT 

0 

0 

1-4 

DIREC 

0 

5-8 

DIREC 

0 

0 

5-8 





0 

1 

9-12 

BIOS* 

1 

9-17 

BIOS* 

0 

1 

13-18 


2 

18 


1 

0 

19-22 

MSDOS * 

2 

19-26 

MSDOS * 

1 

0 

23-27 


3 

27-35 


1 

1 

28-36 


4 

36-44 


2 

0 

37-45 


5 

45-52 


2 

1 

46-54 





3 

0 

55-56 

COMMAND * 

5 

53 


3 

0 

57-63 


6 

54-62 


3 

1 

64-72 


7 

63-71 


4 

0 

73-81 


8 

72-80 


4 

1 

82-90 


9 

81-88 


5 

0 

91-92 

User Files Start On: 







Track 9, Sector 88 



Track 5, Head 0, Sector 3 



And Continue Until: 







Track 39, Sector 359 



Track 39, Head 1, Sector 719 


*IBMBIO.COM, IBMDOS.COM, COMMAND.COMM exist only if the diskette was for- 

matted with the /s option. 
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TheFUe 
Allocation Table (FAT) 


MS-DOS provides the applications programmer with a complete set of program¬ 
ming tools via the function calls it provides for disk access. You do not need to 
know whether the drive you are working with is single or double sided, or has 8 or 
9 sectors per track. MS-DOS uses a descriptor byte in the FAT (file allocation table) 
to determine the format of the diskette being used. 

The FAT maintains a correct mapping of the available and used space on the 
diskette. The FAT occupies one sector under MS-DOS 1.x and two sectors (sector 1 
and 2) under MS-DOS 2.0 and starts at track 0, logical sector 1 for all versions. A 
copy of the FAT is maintained at track 0, sector 2 for MS-DOS 1.x and at sectors 3 
and 4 for version 2.0. Each entry consists of three hexadecimal entries that inform 
MS-DOS as to whether a cluster in use (000) is the last cluster of a file (FF8-FFF) or 
the next cluster number in a file (any other 3-digit hex number). 

When you format a diskette and bad sectors, or sectors which cannot be formatted, 
are found, MS-DOS writes an FF7H in the FAT entry for that cluster to indicate that 
the cluster is bad. Furthermore, the first two entries in the FAT map the directory. 
The first byte of the first entry indicates the format of the diskette as follows: 

FAT Byte 0 » FF » Double sided, 6 sectors per track. 

FE = Single sided, 8 sectors per track. 

FD ~ Double sided, 9 sectors per track. 

FC s Single sided, 9 sectors per track. 

F8 = Hard disk. 

The remaining two bytes of the first FAT entry are always FFFFH. 

This information is not only useful to MS-DOS, which must manage different disk 
formats, but you can make use of this information as well. A little later in this 
chapter. Til demonstrate how to use the media descriptor byte of the FAT in a 
program that reads and sorts the directory, regardless of the diskette’s format. 
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As mentioned previously, page 4-10 in the IBM disk operating system reference 
manual contains the information necessary to convert cluster numbers into sector 
numbers. Only in the most demanding programming applications will you need to 
be concerned with the cluster numbers as depicted in the FAT entries. 

The MS-DOS 
Directory Structure 


The directory for MS-DOS diskettes is found on different sectors and different 
tracks for each of the different versions of MS-DOS. All versions begin the directory 
on track 0. Table 8-4 summarizes the differences between the different diskette 
formats and where the directory can be found. 


Table 8-4 

Where to find the Directory 


Disk Format 

Beginning Sector 

Totai Sectors 

Entries 

SS8ST 

3 

4 

64 

DS8ST 

3 

7 

112 

SS9ST 

5 

4 

64 

DS9ST 

5 

7 

112 


Key: SS8ST = Single Sided 8 Sectors/Track 
DS8ST = Double Sided 8 Sectors/Track 
SS9ST = Single Sided 9 Sectors/Track 
DS9ST = Double Sided 9 Sectors/Track 


Notice that the single sided formats allow a total of only 64 directory entries per 
disk, as opposed to 112 possible directory entries for the double sided formats. 

Each byte of a directory entry has a particular significance. The byte significance 
found in a directory entry is summarized in the listing of the directory read/sort 
program discussed at the end of this chapter and shown in Table 8-5. 


Working with 
MS-DOS Disk Functions 


MS-DOS provides a variety of disk functions to operate on files, directory entries, 
and absolute sectors and tracks. Examples of how the functions are used in a 
program are given in the macro file listing discussed in Chapter 6 (Listing 6-1, 
Appendix D). Use the functions as macros or adapt them as in line code for use in 
your programs. Version 2.0 introduces many new concepts and high level disk 
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Table 8-5 

Format of the Directory 

Byte(s) 

0-7 Filename. If byte 0 = OOH then entry never used. 

E5H then entry has been deleted 
2EH then the entry is for a directory 

Any other character found in byte 0 is the first character of the filename. 

8-10 The file name extension. 

11 The File attribute 00 = Normal File 
01 = Read Only * 

02 = Hidden File 
04 = System File 

08 = Volume Label (in bytes 0-10) * 

10 = Subdirectory * 

20 = Archive Bit, set whenever the file has been written to and 
closed, and has not been backed up. 

12-21 Reserved by MSDOS 

22-23 The time the file was last updated or created. 

Format: B11-15 = Hour (0-23) 

B5-10 = Minutes (0-59) 

BO-4 = two-second increments 
Least significant byte = Byte 22 
Most Significant Byte = Byte 23 
24-25 Date of file creation or update. 

Format: B8-15 = Year (0-119 = 1980-2099) 

B5-7 = Month (1-12) 

B4-0 =Day(1-31) 

26-27 Starting Cluster; See IBM DOS Technical Reference Manual 
Page 4-7 and Page 4-10. 

28-31 File Size in bytes (Least Significant Word = LSB of the size) 

*These attributes are available under MSDOS 2.0 only. Version 2.0 contains all the 
attribute types from 1.0, and adds these new attribute types. _ 


functions that are not found under MS-DOS 1.x. You can find the functions listed by 
function number in Table 8-1. Those marked with an asterisk are available only 
with MS-DOS 2.0. 


The Program Segment Prefix 


I have postponed discussing the PSP as you did not have to know about it or use it in 
the programming examples. However, when working with the disk functions 
available under MS-DOS it is important to understand the PSP’s function and 
organization. Table 8-6 summarizes the PSP. 
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Table 8-6 

The Program Segment Prefix 

Byte(s) 

Function 

0-1 

0CDH20H = INT20H 

2-3 

Memory Size 

(001 OH = 64K, 0020H = 128K, 0040H = 
256K) 

4 

Reserved by MSDOS 

5 

9AH = Long Call to Function Dispatcher. 

6-7 

Offset address of dispatcher (IP) 

8-9 

Segment address of dispatcher (CS) 

OAH-OBH 

Offset Terminate Address (IP) 

OCH-ODH 

Segment Terminate Address (CS) 

OEH-OFH 

Offset Control Break Exit Address (IP) 

10H-11H 

Segment Control Break Address (CS) 

12H-13H 

Offset Critical Error Exit Address (IP) 

14H-15H 

Segment Critical Error Exit Address (CS) 

16H-5BH 

Reserved by MSDOS (2CH contains the seg¬ 
ment for the environment) 

5CH - 6BH (or 80H) Formatted Parameter Area 1. Formatted as 
an unopened FOB. 

6BH-7FH 

Formatted Parameter Area 2. 

80H-0FFH 

Unformatted parameter area, acts as the 
default Disk Transfer Area. 

100H-. 

Start of User’s Program. 


Each time a program is loaded and executed from disk, MS-DOS creates a PSP. It is 
256 bytes in length and extends from offset 0 to lOOH of the segment where your 
program resides. The first byte of your program is therefore at lOOH in the segment. 
The PSP can be used by the program and by MS-DOS to pass parameters to each 
other. As an example, let’s say you want to run a program, but you want to load a 
different data file for use in the main program each time the program is run. You 
could type the following command from the MS-DOS prompt: 

ft> COSTPROB.EXE DfiTft_l.FLE 

Here you have commanded MS-DOS to run the program COSTPROG.EXE and 
passed a parameter to the program (DATA_1.FLE). The MS-DOS program loader 
copies the parameter specified on the command line into the PSP at byte 81H. The 
length of the parameter is copied to the PSP offset byte 80H. A copy of the 
parameter is also placed in the PSP at offset 5CH, which is used by MS-DOS as the 
default file control block (more on FCBs in a moment). 

The program can examine the PSP at location 80H for the length of a parameter 
string and find the parameter string (if any), beginning at offset 81H in the PSP. 
Notice that the first 2 bytes of the PSP consist of an INT 20H instruction. The INT 
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20H instruction restores the MS-DOS environment when at the end of the program. 
It is the normal manner in which user programs are expected to terminate. 

By now you should be accustomed to the fact that every program you write begins 
by pushing the DS register on the stack, followed by a word of zeros. When you 
exit a program via the RET instruction, as is the case in most of the examples thus 
far, a FAR return is executed and register IP is loaded with the word of zeros that 
was stored on the stack. CS is loaded with the segment of the PSP which was 
pushed on the stack at the start of the program. These values form a pointer to the 
first byte of the PSP. After executing the RET instruction, the INT 20H instruction 
at offset OOH in the PSP is executed. 

The net result is that all logic, pointers, and file buffers are restored to the 
environment that existed prior to loading and executing the program. 


File Control Blocks 


When operating on disk files using version 1.x, you need to know what a file 
control block (FCB) is and how it is organized. The FCB contains information about 
the file: the drive number, the filename and extension, the date of creation, and 
pointers into the file. 

An FCB can take on one of two possible forms, normal or extended. The extended 
FCB contains a 7-byte prefix containing the attribute of the file, as summarized in 
Table 8-5. Version 2.0 supports more possible file attributes than does version 1.x. 
Those attributes found in the table and marked with an asterisk are found under 
version 2.0 only. Normal FCBs are 37 bytes in length, while an extended FCB is a 
total of 44 bytes in length. 

In the previous discussion about the PSP, I mentioned that MS-DOS places the first 
parameter specified from a command line in the PSP as a formatted FCB (PSP offset 
5CH). MS-DOS uses this as the default location for the FCB during disk I/O unless 
instructed otherwise. If a second parameter is issued from the command line, it is 
also copied into the PSP, but at offset 6CH. You may have noticed that 6CH is 
neither 37 bytes nor is it 44 bytes from 5CH. Consequently, if you use the default 
FCB at 5CH in the PSP, the second FCB is overwritten and destroyed. 

You can avoid all of this by setting aside memory in your data segment for the FCBs 
used in your program. If you need to have two files open at the same time in your 
program, define two FCB’s in your data segment. If you only have one file open at a 
given time, you can get by with only one FCB. If you intend to pass parameters to 
your program that are actually filenames, move them from the PSP default areas 
5CH and/or 6CH, to the memory you reserved in your program’s data segment for 
FCBs. 
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The FCB bytes you must be concerned about when accessing files under MS-DOS 
are denoted in Table 8-7 with an asterisk. You must set up the drive number, 
filename and extension, current block number, and logical record size. The MS- 
DOS access functions expect these fields to be initialized. When opening or 
creating a file, MS-DOS initializes the record size to 128 bytes. Should you want to 
operate on record sizes greater than or less than this default, it is necessary to 
change the record size for your application. 



Table 8-7 

File Control Block Formats 

Bvte(s) 

Function 

FCB-7 

OFFH = Denotes an extended FCB. 

FCB -6 through -2 

OOH 

FCB-1 

Attribute Byte (See Table 8-5) 

FCB -t- 0 * 

Drive number 0 = default 

1 = A 

2 = B 

After Open: 1 = A, 2 = B 

FCB - 1 - (1 thru 8) * 

Filename. Left justified with trailing blanks. 

FCB - 1 - (9 thru OBH) * 

Extension for filename, left justified, with trailing blanks (or 
all blanks). 

FCB + (OCH thru ODH) * 

Current block number relative to the beginning of a file. 
Each block consists of 128 records, each with a size as 
specified by the word at OEH. This field is used with the 
current record field to perform sequential read operations. A 
value of zero denotes the first 128 records (first block) of the 
file. Initialized to zero by MSDOS. 

FCB -t- (OEH thru OFH) * 

Logical record size. The logical record size Is specified in 
bytes. It must be set after the open or the create functions. 
MSDOS initializes this field to 80H after creating or opening 
a file. 

FCB + (10H thru13H) 

File size in bytes. Initialized by MSDOS from information 
found in the directory. 

FCB + (14Hthru15H) 

Date Field. The date the file was created or last updated. 

FCB 4- (16Hthru1FH) 

Reserved by MSDOS 

FCB -1- 20H * 

Current Relative Record number (0-127), within the current 
block. This field must be set by the user before performing 
sequential record access. 

FCB + (21Hthru24H)* 

Relative record number (also referred to as the random 
record field). This field must be Initialized by you before 
performing a random R/W function call. You can use the 
MSDOS function 24H to set this field based on the informa¬ 
tion In the current block and current record fields. This field 
holds the relative record number from the beginning of the 
file for random record or block access. 

‘User must initialize these fields. Consult the text for an explanation of the FCB. 
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MS-DOS also initializes the current record number to zero. If you want to start at a 
record number other than zero, you have to change the value stored in this field to 
the record number desired. 

Specifying the FCB — 

I Format: MS-DOS Function: OFH 


Macro: @OPEN _ 

When you use the MS-DOS function calls for disk I/O, the FCB for the file you want 
to use is pointed to by DS:DX. For example, to open a file, you would use the MS- 
DOS function OFH. Assuming you have established an FCB in the data segment 
(let’s call it MY_FCB for now), initialize the first 11 bytes as follows: 


Byte 0 = Drive number (0,1, or 2), 

Bytes 1-8 = File name (8 characters maximum). 

Bytes 9-11= The file name’s extension (3 characters maximum). 

Later in this chapter. I’ll show you how to prompt a user for a drive and filename, 
then use the MS-DOS PARSE_STRING function 29H to move the string to an 
unopened FCB. It saves you time and makes life simpler when creating or opening 
files. 

Next, use the following program statements to open the file: 

LEfi DX,MY_FCB jOddress pointsr to the FCB 

MOV ftH,OFH ;MSDOS function code 

INT 21H ;Try to open the file. 

If the file does not exist in the directory, AL will contain OFFH when control is 
returned to your program. If AL contains OOH, the entry was found and the file was 
opened. You can use this information to create a file, if the file specified is not 
found in the directory. See MS-DOS function 16H in Listing 6-1, Appendix D or the 
discussion of the function found later in this chapter. 

The main reason you want to first use the open function rather than the create 
function is that, if you attempt to create a file and the file already exists in the 
directory, MS-DOS will set the file size field to zero. This in effect erases any 
information previously stored in the existing file. The rule here is to study the 
listing of the functions in Listing 6-1 before you use them and know what you are 
doing. 
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When working with the disk access functions having the potential to erase the 
contents of a file or a disk, use a disk with data that can easily be replaced. Never 
experiment on your only copy of a diskette containing valuable data. Now that you 
have been warned by someone who is an expert at erasing disks, let’s move on. 

When using the open or create functions, MS-DOS takes the liberty of initializing 
tbe current block number (FCB bytes OCH-ODH) and the record size field (FCB 
bytes OEH-OFH) to OOOOH and 0080H, respectively. You must change these fields 
after the file has been opened if they are not suitable for your application. If you 
plan to begin with the first block of the file (a block is 128 records) and the record 
size of the file is 128 bytes, then do nothing and leave these fields with the values 
MS-DOS supplies. 

Bytes 10H-16H are also initialized by MS-DOS with the file size and date informa¬ 
tion found in the directory entry for the file. MS-DOS does not initialize the current 
record number byte in tbe FCB (FCB byte 20H). You must initialize this byte after 
opening or creating a file. Usually you will set the record number to zero to access 
the first logical record within the current block. 

The next step before performing a sequential read/write or random access read- 
/write operation is to set the disk transfer address. 


Disk Transfer Address 


Another area that must be established in your data segment prior to using the disk 
access functions is the Disk Transfer Address, or DTA. The DTA is the address of a 
buffer used for disk I/O. It can be thought of as the holding area, or buffer, for data 
that is read from or written to disk. The buffer must be at least as large as the largest 
record length being used in your program. If your record length is 1 byte, then your 
buffer must be 1 byte or greater in length. If your record length is 512 bytes, then the 
buffer must be a minimum of 512 bytes in length. 

When writing to disk, the data must be placed in the buffer. Then, by using one of 
the MS-DOS disk write functions listed in Table 8-1, the data are removed from the 
buffer and written to disk at the current record number specified in the FCB. 
Similarly, when data are read from disk, the data are placed in the buffer. Your 
program is responsible for moving data into and out of the buffer. 

MS-DOS 2.0 contains functions that allow you to set or obtain the DTA. The DTA 
must be set before each write and read operation when multiple files are opened at 
the same time. If you do not set the DTA, MS-DOS uses the last DTA in effect. It may 
be a DTA belonging to another file. When a program is initially executed from MS- 
DOS, not only are the default FCBs built into the PSP but also a default DTA which 
starts at the PSP offset 80H is established. Remember to set the disk transfer address 
with the MS-DOS function lAH prior to using the read and write functions. 
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Creating a File 

I Function: 16H 


Macro: @CREATE_FILE 


The create function tries to locate the specified file in the directory. If found, the 
function uses the OPEN function to open the file, and then sets the file length field 
in the FCB to zero. The effect of this action is to erase the file’s contents. If the 
filename specified is not found in the directory, the create function creates a new 
file, initializes the FCB current block and record fields to zero, and sets the record 
size field to 0080H. You must change these values after the function has returned 
control to your program, should they prove to be unsuitable for your application. 

To invoke the function, move the MS-DOS function code 16H into AH, point 
DS:DX to the FCB which contains the drive, filename, and extension, and then 
issue the INT 21H instruction. On return, AL will contain OOH if an open directory 
was found and OFFH if the file could not be created, as an open directory entry was 
not available. 



Under MS-DOS there are three principal file access mechanisms: sequential read 
and write, random record read and write, and random block read and write. 


Sequential Access 


Sequential access operates on the record pointed to by the current block and 
record number fields in the FCB. After the record has been written to or read from, 
the current block and current record numbers are adjusted to point to the next 
logical record in the file. 

When the current record field is incremented past 128 (the total number of records 
within a block), the current block number is incremented to point to the next 128 
records in the file. It’s a little like the way we tell time. We know there are 60 
seconds to the minute, 60 minutes to the hour, and 24 hours to a day. When we 
exceed 60 seconds, the minute counter of the clock is incremented. 
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The access logic used by MS-DOS is as follows: There are a certain number of bytes 
to a record (determined by the logical record size field in the FCB), 128 records to a 
block, and an indeterminate number of blocks to a file. Since the current block field 
is a 2-byte field, the maximum number of blocks that theoretically could be present 
in a file is limited to 65,536 blocks, each containing 128 records. 

1 admit I have not pushed MS-DOS to such an extreme; yet it gives you some idea of 
the amount of data MS-DOS is capable of accessing. By setting the current block and 
current record fields to a value of your choice, you can begin sequential access 
anywhere in the file. You do not necessarily have to start at the beginning of the 
file. 

Sequential Read ■■■■■■— 

I MS-DOS Function: 14H ~ I 


Macro: @READ_SRECORD 


The sequential read function is invoked by moving the address of the FCB for the 
file to be read into DS:DX, moving the function code 14H into AH, and executing 
the INT 21H instruction. The FCB must belong to a file that has been opened 
previously or created by functions OFH or 16H. The sequential read function reads 
the record pointed to by the current block and record number found in the FCB. 
The logical record size field determines the size of the record that is transferred to 
the DTA. See MACFLE.MAC (Listing 6-1) in Appendix D for a description of the 
error codes returned by this function. 

Sequential Write 

I MS-DOS Function: 15H 


Macro: @WRITE_SRECORD 


This function writes the data from the DTA to disk at the record pointed to by the 
current block and record fields of the FCB. The number of bytes transferred is 
determined by the logical record size field of the FCB. To invoke the function, set 
DS:DX to point to the address of an FCB for the open file, set AH to 15H, and 
execute the INT 21H instruction. See the description of this function in Listing 6-1 
in Appendix D for a description of the possible error codes returned. 

The IBM DOS reference manual states that, should the record size be smaller than a 
sector (512 bytes), the data will be transferred from the DTA to a buffer. The buffer 
is written to disk when the buffer is filled, when the file is closed, or when a disk 
reset command is issued (MS-DOS function ODH). 
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I have had luck with this function only when the record size is divided evenly into 
512: 1,2,4,8,16,32,64,128,256 or 512. When I used a record length of 94 or 27, 
which do not divide evenly into 512, the data written to the buffer were not 
transferred to disk when the file was closed. 

Random Record Access 


Another method of access available to the AL programmer using MS-DOS function 
calls is random record access. If you have ever been involved with one of those 
Saturday afternoon home construction projects, you’ll understand what random 
access is and how it works. 

For your construction project you need to find three items: nails, a hammer, and 
wood. You pick up the telephone book to call around to some of the local 
hardware stores to see if they have what you need in stock. Now imagine that you 
had to look for those telephone numbers by reading the phone book from the first 
page to the page where the numbers are. This would be similar to sequential access. 

Random access allows you to open the telephone book to the page that has Joe’s 
Hardware and Supplies listed, and then to the page containing the number for 
Zebra Nails or YoYo’s Hammers. You do not have to read or wade through every 
entry. This is random access, and it is quite valuable when searching for specific 
records. 

In order to access a record using the random read/write functions available through 
MS-DOS, the random record field of the FCB (bytes 21H-24H) must be initialized 
with the record number desired. The record number specified must be in terms 
relative to the beginning of the file. 

The random record field can be set automatically, based on the information 
contained in the current block and record fields of the FCB. Using the MS-DOS 
function 24H will set the random field based on the current block and record fields. 

Random Record Read 

I MS-DOS Function: 21H | 

I Macro: @READ_RRECORD 

To read a record from an open file using the random record read function, move 
the address of the FCB to DS:DX, the function code 21H to AH, and execute the INT 
21H instruction. On return from the function, the record specified in the random 
record field of the FCB will have been read from disk into the DTA. 
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The random record number will not be altered; it will contain the same value as it 
did prior to executing the random read function. The current block and current 
record fields will be updated to point to the next sequential record in the file. If the 
operation was successful, then AL contains OOH. If AL is nonzero an error has 
occurred. See the MACFLE.MAC listing in Appendix D for a discussion of the error 
codes returned by this function. 


Random Record Write 

I MS-DOS Function: 22H 


Macro: @WRITE_RECORD 


This function writes to disk a record of a length specified by the record size field of 
the FCB. The record written to is specified by the random record number found in 
the FCB (bytes 33-36). To invoke the function, move the address of the FCB into 
DS:DX, set AH equal to 22H and execute the INT 21H instruction. 

When control is returned to your program, AL contains either OOH (the operation 
was successful), OlH (disk was full), or 02H (insufficient space in the DTA to write 
one record). The current block and record numbers are adjusted to point to the 
next sequential record following the record just written to. The random record 
field remains unaltered. 


Random Block Access 


The random block functions enable us to read to or write from disk more than one 
record at a time. Actually, the records are written to or read from disk in a 
sequential manner. IBM and Microsoft use the term random very loosely in describ¬ 
ing this function. Random block write means that the current block and record 
numbers used in sequential access are calculated from the random record field in 
the FCB. They form a pointer to the first record to be manipulated. This may be 
confusing at first, but it really is not as confusing as it sounds. 

The records are part of a block (or blocks) that is read or written in a sequential 
manner. Therefore, it makes sense that the sequential access fields of the FCB are 
used during the operation. The main point to remember is that the sequential 
access fields pertaining to the current block and record are calculated from the 
random record field. 

After either the random block read or the random block write functions have been 
executed, the current random block and random record fields will point to the 
record immediately following the last record written. 
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Random Block Read 

I MS-DOS Function: 27H | 

I Macro: @BLOCK_READ 

This function reads a specified number of records into the DTA. The DTA must be 
large enough to hold the maximum number of records specified. To invoke the 
function, move the FCB address for the open file into DS:DX, the number of 
records to be read into CX, and the MS-DOS. random block read function code 27H 
into AH. Then execute the INT 21H instruction. 

On return, if AL contains OOH, the specified number of records has been read into 
the DTA. If AL contains any other value, the operation was unsuccessful. CX 
contains the actual number of records read and may be compared to the value 
attempted. The MACFLE.MAC listing in Appendix D contains additional informa- 
tion on this function. 

Random Block Write —— 


MS-DOS Function: 28H 


I Macro: @WRITE_BLOCK _ 

This function writes a specified number of records to disk, beginning at the record 
number specified in the random record held of the FCB. To invoke the function, 
set DS:DX to the address of the open FCB for the file to be written to, specify the 
number of records to write in CX, set the MS-DOS function code 28H in AH, and 
execute the instruction INT 21H. 

If the number of records specified in CX is zero, the function will not write any 
records to disk. However, it will alter the file size entry in the directory. The new 
file size is set to the random record field of the FCB. MS-DOS will automatically 
allocate or release clusters as required. 

Use this function with caution. The first time I used it, I erased half of the file I was 
working on. I was trying to increase the size of the file, and somehow specified a 
smaller random record number than the size of the existing file. I set CX to zero, 
and my new file size was half the size of the old one. I have since come to use this 
function with a great amount of respect and caution. Remember, I’m an expert at 
erasing files (I’m getting quite good at restoring them also). 

On return from this function, CX contains the actual number of records written. AL 
contains OOH if the operation was successful and OlH if there was insufficient disk 
space to write the specified number of records. The current block and record 
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number fields and the random record field is updated to point to the record 
immediately following the last record written to disk. 

Closing a File ■' 

I MS-DOS Function: lOH 
I Macro: ©CLOSE 

This function closes the file specified in the FCB pointed to by DS:DX. Files that 
have been opened must be closed using this function. Failure to close a file results 
in the directory not being updated correctly. 

On return from the function, AL contains either OOH to indicate the entry was 
found in the directory or OFFH, which indicates that the entry was not found in the 
directory. To invoke the function, move the effective address of the FCB into 
DS:DX, lOH into AH, and execute INT 21H. 

You are directed to the IBM DOS manual and to the macro definitions found in 
Chapter 6 for a description of the other MS-DOS l.X disk I/O functions found in 
Table 8-1. 



File Handles 


MS-DOS 2.0 implements a new concept in disk access-file handles. A file handle is 
a unique 2-byte number that MS-DOS assigns to a file when it is opened or created, 
using the MS-DOS functions 3DH (open) or 3CH (create). The file handle is 
returned in AX if the operation was successful (see MACFLE.MAC in Appendix D). 
All future references to the file are then made in regards to the file handle. The 
important point to remember is that you do not need to specify an FCB for any file 
you want to work with under MS-DOS 2.0. Simply use the file handle when 
referencing the file. 
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Furthermore, file access has been greatly simplified from the application program¬ 
mer’s viewpoint with the release of MS-DOS version 2.0. You do not have to worry 
about file control blocks when accessing files, as MS-DOS creates its own as 
needed. You still must set the DTA using MS-DOS function lAH when using the 
version 2.0 system calls. 


Tree Structures 


Popular with many advanced operating systems such as Unix (registered trademark 
of AT&T), tree or hierarchical directory structures allow a diskette to store differ¬ 
ent files under different directory names. Each directory name may contain sub¬ 
directories or files. To access a file in a given directory, you need to know the 
pathname. 


Pathnames 


Opening a File —— 

I MS-DOS 2.0 Function: 3DH 


Macro: @OPEN_FILE_2 


Let’s say that you maintain multiple mailing lists and have created the directory 
MAIL. You store mailing lists for work and professional associates and for personal 
acquaintances. The files have been named WORK and HOME. You can use the MS- 
DOS 2.0 function 3BH to move to the desired directory. Once you have chosen the 
proper directory, specify the pathname for the file as: 

d:\MftIL\WORK or d!\MfiIL\HOME 


The primary motivation for the architecture of the directory was to manage the 
massive amount of information the IBM PC/XT is capable of storing on the hard 
disk. With 10 megabytes or more available to the user of the more sophisticated 
machine, the tree structure was essential. There may be only a few different 
working directories shown on the drive, while multiple files may be stored in each 
working directory. 

MS-DOS 2.0 returns a file handle after opening the file. Use the file handle and not 
the pathname when accessing the file using the read and write functions provided 
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under MS-DOS 2.0. To open a file using a pathname, use function 3DH. You must 
also specify the access mode which is either: 

0 for read only 
1 for write only 
or 2 for read/write access 

The access mode must be in AL, and DX must point to the ASCIIZ pathname 
(ASCIIZ is an ASCII pathname terminated with a null byte, OOH). CX must contain 
the file attribute (see Table 8-5), and AH must contain 3DH. Then execute INT 21H. 
On return, if the carry is reset, the operation was successful, and the AX register 
contains the file handle. If the carry is set, then register AX contains an error code 
as follows: 

ftX * 03 = Pathname not found. 

AX = 04 « Too many open files. 

AX = 05 Access denied. 

After using those functions unique to version 2.0, should the carry be set, an error 
has occurred. Under version 1.0, several different and inconsistent methods were 
employed to report errors in using the MS-DOS functions. The different methods 
for reporting errors are detailed in Appendix D in the listing of MACFLE.MAC. You 
should also reacquaint yourself with the disk functions listed in Table 8-1. 

In most of the programming you will be involved in, the functions provided under 
MS-DOS 2.0 are superior to those found in version 1.x. If you are still using version 
1.0, use the version 1.x macros as supplied in MACFLE.MAC and in the manner 
prescribed in their documentation. MS-DOS 2.0 is compatible with those functions 
found in versions 1.0 and 1.1. Therefore, programs written using the disk functions 
provided under MS-DOS 1.x also work under 2.0. 

Creating a File —. - . 

I MS-DOS 2.0 Function: 3CH 


Macro: @CREATE_FILE_2 


This function is similar to the 1.x function, which creates a file such that if an 
existing file is specified, its length is set to zero, thereby erasing the file’s contents. 
To invoke the function, move 3CH into AH, point DS:DX to the ASCIIZ pathname, 
CX to the file attribute (see Table 8-5), and execute interrupt 21H. On return, the 
carry is reset if the operation successfully created a file and set if there was an error. 
See the macro listing for this function in MACFLE.MAC for a complete description 
of the error codes returned. 
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MS-DOS 2.0 
Read/Write Functions 


The read/write functions under 2.0 are: 

1. Read from a file or device: 3FH, 

2. Write to a file or a device: 40H. 

The functions are summarized in MACFLE.MAC. The description explains the 
functions and need not be repeated here. 

Closing a File 

I MS-DOS Function: 3EH 


Macro: @CLOSE_FILE_2 


As I mentioned in the description of the MS-DOS 1.x CLOSE function, a file that has 
been opened must be closed to insure a proper update of the directory entry for the 
file. To close a file that was opened or created using the MS-DOS functions 3DH or 
3CH, you must use the 2.0 CLOSE function. Put the file handle for the open file in 
the BX register and the function code number 3EH into AH, and execute INT 21H. 
On return, the carry is set if an error occurred. If the carry is set, AL contains the 
error code 06H indicating that the file handle you supplied to the CLOSE function 
was not for an open file. 

The other MS-DOS functions found under version 2.0 are detailed in the MAC¬ 
FLE.MAC. I have repeated the most frequently used functions in this chapter, only 
to preface the programming examples you are about to encounter. You should take 
time to study those functions listed in Table 8-1 and read the description of each 
function as given in Chapter 6. The MACFLE listing is quite complete and provides 
you with all the information necessary to use the functions. 



When it is necessary to write disk routines and procedures that directly access a 
given track and sector, two methods of access are available. The first involves using 
the MS-DOS interrupt types 25H (disk read) and 26H (disk write). These are not 
function numbers to be used with INT 21H. They are interrupt types. Use INT 25H 
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for absolute disk access for read operations and INT 26H for absolute disk access 
for write operations. 

The other option is to use the BIOS interrupt 13H for absolute disk access. Use of 
the BIOS interrupt may result in your application program not running on another 
MS-DOS machine due to BIOS differences. The listing MACFLE.MAC contains this 
interrupt function and other BIOS routines. 


Lo^cal versus 
Physical Sectors 


Logical sectors are numbered one less than the physical or absolute sector number. 
For example, the logical sector for track 0, sector 1 is 0. The logical sector for track 
10, sector 1 on a single sided disk with 9 sectors per track is 90. Since there are 9 
sectors per track and we are interested in the first sector of track 10, the logical 
sector number is 90. Similarly, the logical sector for track 10, sector 4 is 93. Logical 
sectors must be specified when using the MS-DOS interrupts 25H and 26H. The 
interrupt functions 25H and 26H of MS-DOS allow data to be read or written to any 
portion of the disk. 


Absolute Disk Access: 
Read Operations 


Set register AL with the drive number (0 or 1 for A or B, respectively), CX to the 
number of sectors to read, DX to the beginning logical sector number, and DS:BX 
to the DTA. Then use INT 25H to read the specified number of sectors into the 
DTA. All registers are destroyed by this interrupt type (except the segment regis¬ 
ters). 

You must use the POPF instruction when the function returns control to your 
program. The status flags are saved on the stack by the interrupt and are not 
restored prior to returning control. If the carry is set after execution of INT 25H, 
AL contains the DOS error code. The possible error codes are summarized in Table 
8-8 and are the same for the absolute write interrupt (26H). 


Absolute Disk Access: 
Write Operations 


Use interrupt 26H to write the information in the DTA to disk. The number of 
sectors to write are specified in CX, AL contains the drive number, and DX must 
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contain the beginning relative sector for the write operation. The error codes 
returned, should the operation fail, are the same as for INT 25H. Table 8-8 
describes these error codes in detail. 


Table 8-8 

Error Codes for Absolute Disk I/O 
Functions 25H&26H 


Error Code Found in AL 


Meaning 


OOH 

Attempted write to a write-protected 
disk. 

01H 

Non-existent parameter 

02H 

Drive not ready 

OSH 

Non-existent command 

04H 

Data error 

OSH 

Bad structure length 

06H 

Seek Error 

07H 

Unknown Media Type 

OSH 

Sector not found 

09H 

Printer Out of Paper 

OAH 

Write Fault 

OBH 

Read Fault 

OCH 

General Failure 



Here are four routines that use many of the disk function calls just discussed. New 
system calls that are not disk related are also discussed and demonstrated. The 
programs have been written to demonstrate how utilities are created. 

Have you ever wondered what actually takes place when you type DIR or COPY or 
some other command from MS-DOS? You have commanded the system to load and 
execute a utility program. The program performs a specific function: DIR displays 
the directory, COPY copies the contents of a file or files to another file or files. I’ll 
demonstrate how easy it is to write simple utilities to perform such functions. 

The four programs listed in Listings 8-1 through 8-4 found in Appendix D are: 

1. NEW_TYPE.ASM, Listing 8-1, a program similar to the MS-DOS TYPE com¬ 
mand. It prompts the user for a file specification, opens the text file spec¬ 
ified, and displays its contents on the screen. 

2. NEW_COPY. ASM, a program similar to the MS-DOS copy command (Listing 
8 - 2 ). 
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3. FAST_COP.ASM (see Listing 8-3), a program that copies the contents of one 
file to another faster than the MS-DOS copy command performs a file copy. 

4. DIRREAD.ASM in Listing 8-4, a program that reads the filenames from the 
directory, sorts the entries in alphabetical order, and displays the names. 

Each program demonstrates different facets about disk I/O and user interface 
techniques, as well as introducing you to a few handy BIOS routines. At times the 
BIOS routines are a better alternative than are the MS-DOS routines to accomplish a 
function. Screen graphics for many display functions are better handled by BIOS 
than by MS-DOS. The same can be said of the limited communications functions 
MS-DOS supplies. 


Programming Example 1: 


NEW_TYPE.ASM- 

The program in Listing 8-1, simulates the MS-DOS TYPE command used in display¬ 
ing a text file’s contents. The program uses the sequential file access. 

The Data Segment ■■ ■— 

The data segment contains keyboard and disk buffer areas. It also allocates space 
for the file control block required to access the file we want to display. Five 
messages are also defined and provide the output portion of the program’s user 
interface. 

Keyboard Buffer ^ 

The keyboard buffer is defined in the usual manner required by the line input 
function OAH. MAX_CHARS is to be initialized within the program before invoking 
the line input function. It signifies the total number of characters to accept from the 
keyboard. 

CHARS_TYPED is the second byte of the buffer area and will contain the actual 
number of characters typed by the user when the line input function of MS-DOS 
returns control to your program. K_BUFF is 20 bytes in length and is initialized 
with ASCII 20H, a space character. Characters entered from the keyboard are 
placed here. 

The Disk Buffer — 

DISK_BUFFER is the buffer where data read from disk is placed. The program must 
set the disk transfer address to the start of this buffer before attempting to use the 
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disk I/O functions of MS-DOS. The buffer is 512 bytes in length; this is also the 
number of bytes in a disk sector. The DUP statement in the data definition 
initializes all 512 bytes with zero. 

Notice that the buffer is terminated with a $. The reason the first byte following the 
buffer is the dollar sign character (24H) is not obvious yet. I used the MS-DOS line 
display function (09H) to display the buffer’s contents. The function requires a 
dollar sign be used as a terminator to the string that is displayed. Using this method, 
you can read a sector from disk and call the line display function to see the contents 
of the disk buffer. You do not have to move the data from the buffer to another 
buffer dedicated to video output. 

The FCB -- 

The next item defined in the data segment is the file control block. The FCB is 
defined as a normal FCB (37 bytes in length). The labels used to describe each field 
in the FCB are descriptive, as shown in the listing. All fields are initialized to zero. 
As the program operates on only one file at a time, we need to define only one FCB. 

Messages — 

All messages that are defined in the data segment are terminated with the $, as 
required by the MS-DOS line display function. 

The Stack Segment —. . .- 

The stack segment reserves 64 words of stack area for the program. We will not be 
doing a lot of pushing, nor will we be using the stack to pass parameters. Therefore, 
only 64 words are reserved, more than enough for the program. 

The Code Segment 

Now look at Listing 8-1. The program starts in the usual manner at label START_1 by 
saving the return address on the stack and initializing the segment registers DS and 
ES. Both are set to point to the base of the data segment. 

The BIOS 
Scroll Function 

One of the handiest BIOS routines is the function used in scrolling a window or 
portion of the video display. The video display is 25 rows by 80 columns wide. The 
coordinates used by this function are therefore in the range of 0 to 24 for the row 
designations and 0 to 79 for the columns. Row 0 and column 0 define the upper 
left-hand corner of the display. 
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The macro definition for the scroll function is invoked at the label START_2 in our 
program. The macro definition may look intimidating on its own, but a full 
explanation of the function is given in the MACFLE.MAC listing and below. 

Basically, the function works as follows: Register AH must contain 06H if you want 
to scroll the display up, and 07H if we want to scroll the display in a down. Next, 
set AL to the number of lines you want to scroll. If AL is set to zero, the entire 
window is blanked. 

Set register CH to the row of the upper left corner of the scroll window, CL to the 
upper left column, DH to the row of the lower right corner of the window, and DL 
to the lower right column number. Register BH must contain the attribute or color 
byte. The attribute and color bytes are illustrated in the MACFLE.MAC listing under 
BIOS video routines. 

After all the registers have been initialized, execute the instruction INT lOH. It is 
shown in Listing 8-1 as INT BIOS, which is really a misnomer, as BIOS has several 
other interrupt types other than lOH assigned to its functions. However, with my 
infinite desire to use the EQU directive, I assigned the label BIOS to the interrupt 
lOH in the MACFLE.MAC file. 

After the function is executed in the program at label START_2, a message is 
displayed asking the user to enter the drive and filename of the file to be displayed. 
Then a carriage return/linefeed is executed to advance the cursor to the next line 
and the MAX_CHARS is set to 15 prior to issuing the MS-DOS function to accept a 
line of keyboard input. 

Program Label: 

GET_]VAME- 

The program is now ready to receive the filename from the user. The macro 
©KBDLINE is executed with the parameter of KEYBOARD, which defines the 
buffer in the data segment that is being passed to the macro. You can enter a 
maximum of 15 characters in the standard MS-DOS format for a file specification as 
follows: d:filename.ext. 15 characters were specified, as the function expects the 
last character accepted from the keyboard to be a carriage return. Therefore, 15 
characters is the maximum that can be typed from the keyboard. The filename 
given may be less than 15 characters, but it cannot exceed this number. 

The PARSE.STRING 
Function ——— 

Now for a little trick in getting the filename from the keyboard buffer, K_BLFFF, to 
the FCB, where it must be placed before we use the MS-DOS function to open the 
file. 
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The PARSE_STRING function (29H) parses a string for a filename and places the 
string in an FCB of your designation. The FCB must not belong to a file that is 
already open. The PARSF_STRING function requires that the effective address (FA) 
of the string to be parsed be in the DS:SI registers and the FA of the FCB be placed in 
the FS:DI registers. 

Register AL must contain an encoded 4-bit combination informing MS-DOS as to 
how the parsing will be carried out. The options available to you are summarized in 
the MACFLF.MAC. I used the encoding as follows: 

Bit 0 s 1 ss ignores any file separators encountered, 

Bit 1 = 1 = leaves the default drive unaltered should the string not 
contain a drive specification, 

Bit 2 3 s 0 = leaves the file name in the FCB unaltered should the string 
not contain a file name. 

Bit 3=0= leaves the FCB file extension unaltered should the user not 
specify an extension. 

You can specify your own method of scanning when using this function by setting 
or clearing these four bits. You should set the high order nibble to zero. 

After setting the register in a manner prescribed, execute the INT 29H instruction. 
The macro @PARSE_STRING sets the registers for you when you specify the EA of 
the string to parse, the FCB, and the encoded bit patterns as parameters. 


Procedure Call: 

OPEN_FILE- 

This procedure invokes the MS-DOS function to open the file specified in the FCB. 
The filename has been placed in the FCB by the PARSE_STR1NG function. When 
expanded by the assembler, the macro @OPFN points DX to the FCB specified as 
the macro parameter, moves the MS-DOS function code to open a file (OFH) into 
the AH register, and executes the INT 21H instruction. 

After MS-DOS returns control to the program, the AL register is checked for a value 
of zero. If AL contains zero, the file was found in the directory and opened. If AL 
contains OFFH, then the entry was not found in the directory. I used this informa¬ 
tion to either reset the carry if the entry was found or to set the carry as an indicator 
to inform the main program that the file was not in the directory. 

If the file is not found, a message is displayed stating such, the keyboard buffer is 
cleared, and the FCB is closed. The carry is set, and control returns to the main 
program. If the file is found, the carry is reset, and the procedure returns control to 
the main program. 
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The fourth source statement in Listing 8-1 following the GET_NAME label uses the 
carry bit as set by the OPEN FILE procedure to ask you for another filename. The 
program branches back to the label START_ 2 if the carry was set on returning from 
the OPEN FILE procedure. 

Program Label: 

SET_UP- 

Once a valid filename has been entered and the file opened, the disk transfer 
address is set via the @SET_DTA macro. The parameter supplied to the macro is 
the buffer for disk I/O, as defined in the data segment, DISK_BUFFER. 

Now you must set the current block and record number to the beginning of the file. 
The value zero is stored in the RECORD_NUMBER and BLOCK_NUMBER fields of 
the FCB (see the data segment). The RECORD_SIZE field of the FCB is set to 512. 
When the MS-DOS function to read a record is invoked, an entire sector is read to 
the disk transfer address. When MS-DOS opens a file, the record size is initialized to 
128 bytes (80H). 

Program Label: 

READ.RECORD- 

The macro @READ_SRECORD invokes the MS-DOS function to read the record 
specified in the RECORD_NUMBER and BLOCK_NUMBER fields of the FCB into 
the FCB. Since the record size has been set to 512 bytes, an entire sector is read into 
the DTA. 

On returning from the function, register AL is checked for a value of zero, indicat¬ 
ing that the read operation was successful. A nonzero value indicates that an error 
has occurred. Control is transferred to the code at the label READ__ERROR when an 
error is encountered or to CONTINUE if there were no errors. 

Program Label: 

CONTINUE- 

At the program label CONTINUE, the macro @VDLINE invokes the MS-DOS line 
display function (09H). This is a unique manner in which to use the function. The 
function is primarily used in displaying messages on the screen. Here we use the 
function to display the entire disk buffer at one time. That is why the disk buffer is 
terminated with 24H ($). You can use this function to treat the disk buffer as if it 
were simply an ASCII message you want to display. Can you see a potential 
drawback to this technique? (Hint; Don’t use the $ character in a file you want 
displayed using this program. Try rewriting the portion of the program that 
displays the disk buffer, and fix this potential bug.) 
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After displaying the disk buffer, the program performs a jump backward to the 
program label READ_RECORD, and the process is repeated. 

Program Label: 

READ.ERROR- 

We’ve followed the program logic flow through a no-error condition after the read 
operation. Now let’s look at the logic flow when register AL contains a nonzero 
value after a read operation. 

We can determine the value in AL by using one of my favorite methods, decrement¬ 
ing the register and checking for zero. The decrement instruction for 8-bit values 
requires 3 clocks to execute, compared to 4 clocks for a register immediate 
compare, such as CMP AL,01H. Execution time is not a critical issue in this pro¬ 
gram, yet I want to bring little programming quickies like this to your attention. 
Here the execution time for the DEC AL instruction is exactly half that of an 
instruction that accomplishes the same function—setting the zero flag. 

AL can contain one of three possible error codes on returning from the function. If 
a read operation was attempted and the first byte encountered during the read was 
an end of file (EOF) character (lAH), then AL will contain OlH and there will be no 
data in the DTA. If AL contains 02H, there was not enough room in the DTA to 
transfer one record. This can occur when the DTA is smaller than the record size in 
the DTA. If AL contains 03H, then a partial record was read into the DTA before the 
EOF was encountered. 

When the EOF is encountered (AL =01H), the program branches to the label 
EOF_FOUND. A message is displayed announcing that the sequential read opera¬ 
tion has been completed, the file is closed, and the program terminates. All files 
must be closed using the MS-DOS function lOH, which closes the specified FCB and 
updates the disk’s directory. Should you fail to use the CLOSE function, the 
diskette will not be updated correctly and some or all of your data may be lost. So 
be sure to close any open files before you terminate a function. 

The DTA too small (AL = 02H) error code should not occur in this program, since 
the DTA is as large as the record size. However, if the error should occur, the 
program branches to the label DISK_ERROR, which displays a fatal error message 
before exiting the program. 

Partial record read: (AL = 03H) when files are not exactly divisible by the record 
size, (512 bytes in our program). In this case, the last data in the fi.le does not form a 
complete record. Therefore, this error code informs the program that it was unable 
to transfer the requested record size to the DTA prior to encountering the EOF 
character. 
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The program branches to the program label DSP_PARTIAL, which displays a 
partial record before exiting the program. The D1 register is used as an index into 
the disk buffer to point to the next character to be processed. DI is initially set to 
zero to access the first byte in the buffer. The value pointed to by the base address 
of the disk buffer and DI is moved into the DL register. DL is compared to lAH, 
which is the end of file character used by MS-DOS. 

If the character is found, the program branches to EOF_FOUND. If the character in 
DL is not lAH, then the program displays the character using the macro 
@CHARDSP. DI is incremented to point to the next byte in the disk buffer, and the 
program branches back to DSP_PARTIAL, which fetches the next byte from the 
buffer. Notice how the indexed mode of addressing is used to access the data in the 
buffer. 

I will not go into as much depth with the rest of the programming examples. 
However, any new MS-DOS or BIOS functions introduced are discussed in detail 
for better understanding. 



This program copies the contents of one file to another and can be found in Listing 
8-2. The program is slow. It is useful only for files less than 4K in length. 
NFW_COPY.ASM demonstrates the sequential read and sequential write functions 
found in MS-DOS 1.x and 2.0. 

One note of caution: because the program illustrates how a copy command is 
defined, it should not be used to copy large files. The program works, but at a 
snail’s pace. Try the program out on smaller files (4K or less), and you won’t have 
to go get a cup of coffee while the program executes the copy. 

In the previous program (NFW_TYPF.ASM), only one FCB was required, as there 
was only one open file in the program, the file being read from. To perform a copy, 
we must specify two FCBs in the data segment, as there will be two files open at a 
time: the source file being read from and the destination file being written to. 

I used the same format and descriptors to define the first FCB as in the previous 
example, except that I refer to the first FCB with the symbolic name FCB_1. The 
second FCB is naturally referred to by the name FCB_2. Notice in Listing 8-2 that 
the second FCB uses a D suffix after the field definitions within the FCB. For 
example, the destination drive number field is named DRIVF_NUMBER_D. The 
destination fields were named in this manner to differentiate them from the source 
labels of similar names. 
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Messages . . 

The messages necessary to prompt the user for the source and destination files are 
also defined in the data segment. The program even tells the user whether the 
destination file is new or if it already exits. If it already exists, the file is overwrit¬ 
ten, and the previous contents are lost. A more well-mannered copy routine would 
ask you if you really want to overwrite the file. This is not done in this program, but 
it would be a worthwhile exercise for you. 

Another RAM location, named BYTE_COUNT, is also defined in the FCB. The 
program uses this location as a record counter when writing to disk. The program 
initializes the record size field to one in both the source and destination FCBs. 
Therefore, one record is 1 byte in length. The BYTE_COUNT informs the program 
when 256 bytes have been written to disk. 

Program Label: 

START_2- 

In Listing 8-2, the second instruction following the label START_2 invokes a 
macro, which sets the cursor to the specified screen location. To invoke the macro, 
supply it with the screen number and the row and column coordinates. A row value 
of 0-24 or column number of 0-79 is acceptable. 

The macro is expanded, and the screen number passed to the macro is placed in 
BH, the row number in DH, and the column number in DL. The contents of register 
AH are set to the value 02H and an interrupt lOH is executed. The cursor is set to the 
position specified on the screen number that was specified. 

The program statements appearing at the label GET_NAME prompt the user for the 
source filename, parse the string, and place the filename entered into FCB_1. If the 
procedure OPEN_FILE finds the file in the directory, it is opened and the carry flag 
is reset. If the procedure is unable to locate the file in the directory, the carry is set 
to indicate an error has occurred. The program displays a message to inform you 
that an invalid filename was entered and you must reenter the filespec. The 
program branches to the label START_2, which restarts the program. 

Assuming the filename was good, the program continues at the label SET_UP. The 
disk transfer address is set to point to the DISK_BUFFER, which is defined in the 
data segment. Only 1 byte is allocated to the DISK_BUFFER. The program works 
with source and destination record sizes of only 1 byte. Therefore, any record read 
or write operation will read or write only 1 byte from or to disk. 

You might wonder why we do not need to define a second buffer for the destina¬ 
tion file. The reason is simple. Since we want to write the data read from disk, we 
can use the same buffer for reading as we do for writing. When a byte of data is read 
from the source file, it is written to the destination file. Other applications will no 
doubt require separate buffers for each file manipulated by your program. 
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Next, the program invokes the macro to set the disk transfer address. The FCB 
fields are initialized to the starting block and record number (zero), and the record 
size is set to one. The program calls the GET_SECOND procedure, prompting the 
user for the second, or destination, drive. The procedure also creates the file if it 
does not exist, or, if the filename specified belongs to an existing file, the pro¬ 
cedure sets the file’s size to zero, erasing the previous contents of the file. 

The fields RECORD_NUMBER_D, BLOCK_NUMBER_D, and RECORD_SIZE_D of 
FCB_2 are initialized to zero, zero, and one. The fields are set to the same values as 
in the source FCB_1, because we want to start from the beginning of each file when 
reading from the source file and writing to the destination file. The block and 
record numbers in each are therefore set to zero. The record size is set to 1 in both 
the source and destination FCBs to insure that what we read is what we write. 

Program Label: 

READ.RECORD —— 

We are now ready to read a record from disk. This portion of code reads a record 
from disk and checks AL for error codes. If AL contains OOH, then there were no 
errors and the program continues. The record just read is then written to disk. 

Program Label: 

CONTINUE- 

The macro @ WRITE_SRECORD writes a record to disk from the DTA. The param¬ 
eter of the FCB belonging to the file to be written to is passed to the macro. If there 
are no errors after performing the write operation, the RAM location 
BYTE_COUNT is incremented. 

When the BYTE_COUNT equals OFFH and is incremented, the counter is said to 
roll over to zero. When this happens, the zero flag is set in the flag register. The 
program then executes the instructions to display an asterisk (*) on the screen. This 
lets the user know every time 256 bytes of data have been written to disk. 

After the write operation is completed, the program branches back to the label 
READ_RECORD, where the next record is read from disk. The entire read/write 
portion of the program is then repeated. 

The program checks for read errors at the label READ_ERROR and write errors at the 
label WRITE_ERROR. Examine these portions of code and see how I handled errors in 
the program. Notice in the READ_ERROR portion of code that if AL returns with 
02H or 03H after a read operation, the program jumps to the DISK_ERROR routine. 
The 02H error code signifies that the DTA was too small to hold one record as read 
from disk. Since we defined a record size of 1, and the DTA size is 1, this error code 
does not make much sense in this application. Therefore, if it should occur, it is 
flagged as a hard, or unrecoverable, error, and the files are closed. 
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Similarly, if the error code is 03H, MS-DOS is informing you that an EOF was 
encountered and that a partial record is in the DTA. Again, with a record length of 1 
having been specified, this error makes little sense. Should it occur during this 
program’s execution, it is flagged as a hard error. If our record size were greater 
than 1, these errors would have some relevance. 

When the EOF character is encountered in the source file, a dash (-) is displayed on 
the screen, and the source and destination FCBs are closed. The close operation 
updates the destination file’s directory entry properly before the program termi¬ 
nates. 

Assemble this program, and try it out on a few small files. Then try it on a large file. 
Try NEW_COPY.ASM to copy a file of at least 50K in length. Get up, go out, cut the 
lawn, fix and eat dinner, and then come back and see if the program is finished. The 
copy does not take quite that long as I just described, but it seems to when you’re 
watching the asterisk appear on the screen every time 256 bytes are written to disk. 
Surely there must be a faster method to simulate the MS-DOS COPY command. 
There is and the program is listed in Listing 8-3- 


Programming Example 3: 

FAST COP.ASM 


FAST_COP.ASM uses the random block read and write functions to copy the 
contents of one file to another. A little trick speeds up the copy process. The record 
size specified is 1 byte as in the previous example, but rather than reading one 1-byte 
record at a time, the program reads a block of 1-byte records into the DTA. 

Each time the program reads from the source file, the block read function attempts 
to read 32,767 records into the DTA. Since we are working with 1-byte records, the 
disk buffer size is defined in the data segment as 7FFFH, or 32,767 bytes in decimal. 
A key point to remember is that the disk buffer must be set to a size equal to or 
greater than the product of the record size and the number of blocks read. 

If you recall from the discussion of the random block read function earlier in this 
chapter, the number of blocks to be read is placed in the CX register prior to 
invoking the function. Be sure that the number of records is nonzero, or the file size 
will be altered. Also be sure the disk buffer (as defined by setting the DTA) is large 
enough to store the number of record blocks specified. 

As in the previous program, only one disk buffer is used in this example. Two FCBs 
are still required: one for the source file and one for the destination file. 
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Program Labels: 
SET_UP and SET_UP_D 

I Macro: @SET_REL_RECORD 


The macro definition invokes the MS-DOS function to set the random record field 
of the FCB (hytes 21H-24H) to the relative record, as computed hy the current 
block and current record entries in the FCB. The current block and record numbers 
are initialized to zero before using this function. 

To invoke the function, use the macro @SET_REL_RECORD with the FCB you want 
altered. The program invokes the function twice, once for the source file and once 
to set the random record number in the destination FCB. When the macro is 
expanded, the effective address of the FCB is moved into the DX register, and the 
function code 24H is moved into AH. Next, the INT 21H instruction is executed. 

Program Labels: 

READ.RECORD and 

CONTINUE- 


Macros: ©BLOCK BREAD and 
@BLOCK_RWRITE 


The random block read function is invoked via the macro @BLOCK_RREAD at the 
program label READ_RECORD in Listing 8-3. To use the macro definition, specify 
the FCB of the file you want to read from, the number of record blocks you want to 
read (7FFFH, in this program), and the record size. Although the record size field in 
the FCB is defined after opening the source file, this macro when expanded insures 
that the record size field is set as desired before the block read is performed. 

The macro expansion moves the effective address of FCB_1 into the DX register, 
the block count into the CX register, and the block read function code 27H into AH. 
The INT 21H instruction is then executed. If there was an error, the program 
branches to the label READ_ERROR. The only error that is unrecoverable is when 
AL contains 02H on return. If AL equals OlH or 03H, then a partial record was read, 
and CX contains the number of records read. 

If the read operation is successful (no errors; AL = OOH), then the program writes 
the entire block of records to the destination file. The macro @BLOCK_RWRlTE is 
invoked by specifying FCB_2, the number of blocks to write (7FFFH), and the 
record size (OlH) in the argument field of the macro. The only error of interest 
occurs when there is insufficient disk space available to write the number of 
records specified. 
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If a partial record was read because the read operation encountered the EOF 
character, CX contains the actual number of records read. This value is used by the 
macro @BLOCK_RWRITE when it is invoked at the program label PART1AL_3. In 
this manner, 32K records (bytes) are read every time the program reads from the 
source file, and 32K bytes are written every time the program writes to the 
destination file. When a partial read occurs on the last portion of the source file, the 
number of bytes read will be written to disk, as specified by the contents of CX. 

The program terminates in the usual manner by closing the FCBs and returning to 
DOS. Time this program against the MS-DOS COPY command. I found it to be 2 or 
3 seconds faster when copying a large file. A good exercise for you would be to 
modify the program so that the source and destination filenames can be specified 
from MS-DOS as part of the command line as follows: 

ft> FftST_COP BsTESTFILE.FLE TEST2.TXT 

The filenames will reside in the default FCBs in the PSP of the program. You can 
then move the names to your data segment and create new FCBs from the names 
passed on the command line. Remember that when your program begins, the DS 
register will contain the segment address of the PSP and your program. 


Programming Example 4: 

DIRREAD.ASM 


This last program uses the absolute disk access interrupt type 25H to directly read a 
specified number of sectors from whatever starting sector you specify. The func¬ 
tion was discussed earlier in this chapter. Specifically, the program will read the 
directory of a specified drive, sort the directory entries into alphabetical order, and 
display the names on the video screen. The source program can he found in Listing 
8-4. 


Procedure: 

GET_DRIVE_TYPE- 

Find the procedure GET_DR1VE_TYPE, near the end of the program in Listing 8-4. 
This procedure determines the characteristics for the drive number specified by 
the user. The first byte in the file allocation table describes the drive type (number 
of sectors per track, single or double density, etc.). 

On entry to the procedure GET_DRIVE_TYPE, all registers are saved, and the 
registers necessary to access the FAT are initialized with the proper values. Register 
BX must point to the disk buffer where the data read from disk is transferred. AL 
must contain the drive type, either 0 or 1. CX must contain the total number of 
sectors to read (one, in our example), while DX specifies the beginning sector 
number, which is one. Next the INT 25H instruction is executed. 
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The FAT begins at track 0, sector 1 for all versions of MS-DOS. The FAT always 
starts on the sector immediately following the boot sector. That is why DX is 
initialized to 1. Since we are only interested in the first byte of the FAT, only one 
sector need be read (CX = 1). 

The status flags are then popped from the stack, and, if the carry is reset (no carry 
condition), there were no errors. The data read from disk is in the DTA. At the label 
NO_ERR2, the first byte transferred to the DTA is transferred to AL. The different 
possible drive types and the corresponding FAT entries were summarized in the 
discussion of the FAT earlier in this chapter. The program determines the drive 
type from the value of this byte. 

The data segment locations D1R_SEC, DIR_BEG, and ENTRIES are initialized to the 
proper values based on the drive type. DIR_SEC contains the total number of 
directory sectors possible for a given drive type, while DIR_BEG contains the 
beginning sector number of the directory. ENTRIES is initialized to the total 
possible directory entries for the drive type, as summarized in Table 8-4. 

After the drive type is determined, the program restores the registers and returns to 
the main program following the CALL instruction to the procedure (find the label 
ALL_RIGHT in the source file). The absolute disk read interrupt is invoked using 
the parameters recovered from the first byte of the FAT. DX is set to the value of 
DIR_SEC, which specifies the number of sectors to be read, and CX is set to the 
beginning directory sector, DIR_BEG. BX points to the disk buffer, and the the INT 
25H instruction is executed. The entire directory is read into the disk buffer. 
Assuming there were no errors, the program calls the routine to sort the directory 
entries. 

Procedure: 

DIR.SORT- 

The procedure DIR_SORT sorts the entries in the disk buffer in alphabetical order. 
The format for the directory entries is important as the filename is specified in 
bytes 0-10. If byte 0 of the directory contains OOH, then the entire entry was never 
used. If byte 0 contains E5H, the entry has been previously deleted. 

The procedure skips empty or deleted entries. When an active entry is found, the 
filename in bytes 1-10 of the directory entry moved to another buffer (DIR_BUF2), 
which is where the filenames will be alphabetically sorted. 

At the program label MOVE_DIR, DI and SI are set to the effective addresses of the 
destination buffer (DIR_BUF2) and the source buffer (DIR_BUFF). The direction 
flag is cleared by the CLD instruction. This is in preparation for the MOVSB 
command, which moves a byte from the DS:SI pointer to the ES:DI pointer. A 
count value of 11 is moved into the CX register. Eleven is the total number of 
characters found in the filename field of a directory entry. 
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Next, REP MOVSB, a repeated move instruction, is executed. Each time the instruc¬ 
tion is repeated, a byte of data is transferred from the address formed by DS:SI to 
ES:DI. The pointers SI and DI are automatically incremented after each MOVSB is 
executed, and register CX is decremented by one after each MOVSB. The move is 
repeated as long as CX contains a nonzero value. This is a very efficient method of 
moving a string from one place to another. 

Next, the pointers are adjusted to point to the next directory entry in DIR_BUFF, 
and the entire process is repeated. After all of the filenames belonging to active 
directory entries have been moved to DIR_BUF2, the procedure begins the sorting 
process. 

Program Label: 

DlR_SORT2-- 

Many methods have been devised to sort data efficiently. Perhaps the most popular 
algorithm is the bubble sort. In effect, two adjacent entries in a list are compared. If 
the second item in the list is less than the first, the entries are swapped. A flag is set 
to indicate an exchange took place on this pass through the list. 

Next, the second and third entries are compared. If the third is less then the second, 
the entries are swapped and the flag set. This process continues for all items in the 
list. After the last two items have been compared, the swap flag is checked. If the 
flag is set, the list is again compared from the top down. When a pass of the list 
results in no entries being exchanged, the list is said to be in order, and the sort is 
complete. 

Naturally, if a list can also be sorted in descending order, it can be sorted in 
ascending order. The option is left to the programmer and dictated by the applica¬ 
tion. 

The portion of code that is of interest in the sort routine begins at the label 
DIR_SORT_3. The source string is compared to the destination string byte for byte. 
As long as the characters compared are equal, the operation proceeds until all 8 
characters in the filename have been compared. This is accomplished by, REPE 
CMPSB. 

When the procedure DIR_SORT2 is first entered, the pointers to the source and 
destination strings are pushed on the stack along with the number of directory 
entries the procedure is to sort. This is significant, as the procedure that swaps the 
entries acesses these parameters from the stack. I used this method of parameter 
passing to illustrate paramater passing via the stack. 

If the destination string is lower in value than the source string, the procedure calls 
SWAP_ENTRY to swap the entries. SWAP_ENTRY begins by saving the BP register 
on the stack and moving the current value of the stack pointer to the BP register. 
This allows us to access the stack using BP and a displacement value. 
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Next, the source and destination pointer values are moved from the stack to the SI 
and DI registers. Now for a little magic. The byte pointed to by DI is moved into AL. 
AL and the contents of the memory location pointed to by SI are exchanged (XCHG 
AL,[SIl). Now that AL contains the byte found in the source string, it is saved at the 
same byte location in the destination string. It’s a quick and efficient way to 
exchange memory operands. 

All 11 bytes in the source and destination filename are exchanged in this manner. 
The exchange flag is set to a nonzero value to indicate that an exchange took place. 
Study this procedure and the stack parameter-passing technique. You’ll find it 
handy in many programs you write. 

After the directory entries have been sorted, the procedure returns to the main 
program. You can modify this routine to fit almost any application where a bubble 
sort is required. 


Procedure: 

CHECK.BOUNDS- 

In Chapter 7,1 promised you a procedure that can be used to check bounds on a 
number. This is the procedure. As illustrated in Listing 8-4, the routine is very 
simple. It alters no registers except the flag register where the carry bit reflects the 
result of the comparisons. 

The procedure expects to find a minimum byte value stored in RAM location MIN, 
with the maximum value in the RAM location MAX. The procedure compares the 
contents of AL against the values stored in these locations. If the value in AL is less 
than MIN or greater than MAX, the carry is set to reflect that the number in AL is not 
in the specified range. If AL is in range, the carry is reset when the procedure 
returns to the calling program. In this program, the procedure is used to compare 
AL to valid drive numbers as entered by the user. 


Procedure: 

DIR-DSP- 

This procedure displays the sorted directory entries stored in DIR_BUF2 in the 
data segment. The routine formats the display so that 4 filenames are displayed on 
each line. As there are 24 lines available for display on the IBM PC video screen, the 
total number of entries that can be displayed at a time before the screen begins to 
scroll is 4 X 24, or 96, entries. 

The maximum number of directory entries on a 9-sector, double sided disk is 112. 
The program pauses after displaying 96 entries and waits for you to press a key 
before displaying the remaining entries. This avoids unwanted directory scroll. If a 
directory contains more than 96 entries, the pause gives you a chance to read the 
filenames before they are scrolled off the screen. 
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The program’s documentation, as found in Listing 8-4 explains each program line 
in detail. You will now be able to experiment with the functions MS-DOS provides 
in handling disk I/O in your own programs. Use these examples as the basis for 
future experimentation. In the next chapter, I’ll discuss the BIOS functions as used 
in the example programs presented. These functions and others can be found in the 
macro file of Listing 6-1. 



1. Using MS-DOS 1.0 and 1.1, a disk_must be estab¬ 

lished in memory before attempting a disk read or write operation. 

2. The purpose of the DTA is to provide a_for data transfers to 

3. Name three types of disk access. Briefly describe each. (Compare your 
answer to the description given in the text.) 

4. Using MS-DOS 2.0 you still need to define a DTA. (True or False) 

5. Using MS-DOS 2.0 you still must define an FCB. (True or False) 

6. You can find the macros for disk functions listed in Chapter_. 

7. A utility is actually a mini-_. 











In this chapter I want to deviate from the functions used under MS-DOS. While it 
provides a very complete set of user functions for disk I/O and character oriented 
keyboard and display processing, MS-DOS lacks routines that efficiently allow you 
to use graphics and sound. The BIOS functions used in this chapter can be found in 
MACFLE.MAC (Listing 6-1), following the MS-DOS functions. 

The BIOS functions are one level above the actual hardware implementation of the 
machine. As mentioned in previous chapters, MS-DOS functions are the highest 
level (from the AL programmer’s standpoint), with BIOS being the next level. MS- 
DOS uses the BIOS routines to perform the functions discussed thus far, with the 
exception of disk I/O, which is handled entirely by MS-DOS. 

This linkage to BIOS provides you with a layer of isolation from the operating 
system. BIOS communicates directly with the devices attached to the system. MS- 
DOS communicates with the system resources through the Basic Input/ 
Output System. Portions of BIOS are implemented differently from machine to 
machine. Therefore, many programs using BIOS will run on only the machine for 
which the program was written. Other 8088/86 or 80186/MS-DOS machines may 
not be able to run the program, due to a different implementation for a given 
function. 

A good example of low level incompatibility is the CONFIGSY.ASM program 
discussed in Chapter 2 (see Listing 2-1, Appendix D). The program uses BIOS 
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interrupt IIH to return a binary word in AX that describes the system’s resources. 
Each bit or combination of bits in the word is set or reset depending upon whether 
a particular resource is available to the system. The significance of each bit in the 
word is different on the TANDY 2000 MS-DOS machine and the IBM PC. If the 
program in Chapter 2 were assembled and run on the TANDY 2000, the informa¬ 
tion returned by the function would be different than for the IBM PC. Table 9-1 
summarizes the bit significance of each bit returned by this function on the two 
different machines. 



Table 9-1 

Equipment Flag Differences 
BIOS Interrupt IIH 



Tandy 2000 


IBM PC 

Bit # 

Meaning 

Bit # 

Meaning 

0 

TV/Joystick 

0 

Disk Drives Present 

1 

Monochrome Graphics 

1 

Not Used 

2 

Monochrome Graphics 
with Color Option 

2&3 

Planar Ram Size 

00 = 16K,01=32K 

3 

Floppy Drive 1 


10=48K, 11=64K 

4 

Floppy Drive 2 

4&5 

Video Mode 

5, 6,7 

Not Used 

6&7 

00=Unused 

01 =40 X 25 

BA/V, Color Card 
10=80 X 25 

B/W, Color Card 
11=80 X 25 

B/W, Monochrome 
Number of disk 
drives. 

8 

B/W Monitor 

8 

Unused 

9 

10 

11 

Color Monitor 

TV Monitor 

Not Used 

9.10,11 

Number of RS-232 Cards 

12 

Joysticks 

12 

Joysticks 

13 

Printer 

13 

Not Used 

14 

15 

Not Used 

Not Used 

14&15 

Number of Printers 


Table 9-1 shows the differences between the Tandy 2000 and the IBM PC in the 
interpretation of the equipment flag returned by BIOS INTIIH. Both machines are 
MS-DOS compatible, although the BIOS functions are implemented differently. 

BIOS must be used to perform those functions MS-DOS lacks—graphics, commu¬ 
nications, etc. While MS-DOS provides functions for sending a character to the 
printer port (function 05H, INT 21H) and to the communications channel (INT 21H, 
function 04H), the functions MS-DOS supplies are minimal and not suitable for a 
wide variety of programs. 
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For example, the serial I/O routines link themselves to BIOS and look for certain 
voltage levels to be present at the RS-232 connector of the serial board. These 
signals are named Clear To Send (CTS), and Data Set Ready (DSR). They are usually 
supplied by a modem (Data Circuit Equipment, or DCE) attached to the PC. If you 
want to transmit a character via the serial board and DSR and CTS are not present, 
the BIOS transmit routine waits a specified amount of time for the signals to be 
asserted. If after the specified time, the signals are not sent, the routine returns, and 
the character is never sent. 

Similarly, when you want to receive a character from the communications chan¬ 
nel, the MS-DOS function 03H could be used. Other processing chores are tem¬ 
porarily suspended while the routine waits for a character to arrive at the serial 
port. This delay could prove to be critical if other processing chores must be 
executed in real time (without delay). 

The delay is unacceptable for another reason. Since characters arrive in an 
asynchronous manner, their arrival is not predictable. Therefore, your program 
must continually sample the communications port via the MS-DOS 03H function, 
so as not to miss an arriving character. Given the delay inherent in the function 
when a character is not ready, your program would do little else besides polling the 
serial port for a character. 

Since the serial I/O functions link themselves with BIOS routines, the BIOS routines 
are responsible for the manner in which the call executes. For serial I/O, it is best to 
skip the MS-DOS and BIOS routines altogether and directly access the serial 
communications board and the 8250 UART (Universal Asynchronous Receiver 
Transmitter), an integrated circuit responsible for handling serial communica¬ 
tions. I know this sounds contradictory to my previous argument of using MS-DOS 
function calls to maintain compatibility between MS-DOS machines; however, 
certain MS-DOS functions simply do not provide you with the power you need to 
perform a function from within the program. Serial communications is the subject 
of the next chapter, where I’ll show you how to install your own RS-232C 
interrupt handler and overcome the communications handicaps MS-DOS and BIOS 
impose upon you. 

Other functions, such as scrolling a portion of the display or setting the cursor to a 
specified position on the display, are totally absent from MS-DOS. You must use 
the BIOS routines to perform these functions, or directly program the chips that 
carry out these functions. The further from MS-DOS your program deviates, the 
more likely that the program will run on only one type of machine. Because the 
chips themselves may not be at the same port address on every machine, the 
programs written for an IBM PC may only execute on that machine and not one of 
the many so called compatibles. 

With all these caveats in place. I’ll now discuss some of the BIOS routines as they 
pertain to the video display and the printer. You can use these functions to write 
graphic routines and spice up your video output. They give you complete control 
over the monochrome and color adapters used in the IBM. 
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There are two printer adapters used in the IBM PC. The first is found on the 
monochrome display adapter. The printer is mapped to the following port 
addresses: 

Port Function 

03BCH Printer data - Output 

03BDH Printer status - Input 

03BEH Printer control -Output 

When the parallel printer adapter board is installed in the system the port assign¬ 
ments for the printer are as follows: 


d378H 

Printer 

data - Output 

0379H 

Printer 

control - Output 

037ftH 

Printer 

status - Input 


In most of your programming endeavors, the ports will not be directly accessed. 
Instead you will use one of the MS-DOS or BIOS routines to perform printer I/O. 
The only MS-DOS function call for the printer port is function 05H (INT 21H). This 
function outputs a character in DL to the printer, and it has been incorporated into 
a macro call in Chapter 6. 

If you want to exercise more control over the printer port, you can use BIOS 
interrupt 17H and one of the three functions BIOS provides. You can send a 
character in AL to the printer by moving the function code OOH into AH and 
executing INT 17H. This method is preferred over the MS-DOS function call, 
because the status of the printer port is returned in AH as follows: 

b0 * 1 = Time out 
bl = 1 * Undefined 
b 2 = 1 * Undefined 

b3 1 a Select error (printer off-line) 

b 4 a 1 ss Printer selected 

b5 =s 1 * Paper out condition 

bS * 1 = PCK 

b7 = 1 = Printer busy 
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The port status is returned as above when the read status function is executed 
(BIOS function 02H, INT17H). To reset the printer, move OlH into AH and execute 
INT17H. An example of a printer I/O is given in the next chapter. 



The Monochrome Adapter 


Two different video boards are used with the IBM PC. The first is the monochrome 
adapter and allows the display of text (alphanumeric characters) on a black and 
white screen formatted as 80 columns by 25 lines. The adapter contains 4K of 
video memory, starting at the absolute address of OBOOOOH. 

Two bytes are required to fully describe each character appearing on the screen, 
and only one 80 by 25 page of text can be held in the adapter’s memory at a time. 
Since 80 x 25 = 2000 characters, and 2000 characters x 2 bytes = 4K, the 
memory required per screen is 4K. 


Monochrome 
Character Attributes 

The adapter stores not only the characters that are displayed but also each char¬ 
acter’s attribute. The attribute byte tells the display logic whether the character is 
to be displayed in normal mode (white on black) or reverse video (black on white). 
The attribute also dictates whether the character is to be underlined or blinking, or 
both and specifies the intensity level (normal or high) for that character’s position. 
Characters are stored at even addresses in the adapter’s memory buffer, and the 
attribute codes are stored at odd memory locations in the buffer (i.e., OBOOOOH = 
character, OBOOOIH = attribute). 

The attribute byte is formed as follows: 

B7 = 1, the character blinks 
B6 B5 BA =s Background 
111 = White 
000= Black 

B3 = 1, then the character is displayed in high intensity 

continued 
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B2 B1 B0 * Foreground 
111= White 
0 0 0= Black 


The Color/Graphics Adapter 


The color/graphics adapter board allows either alphanumeric text, or graphics to 
be displayed. You can use a special high resolution RGB monitor, or you can use an 
RF modulator to drive a color television. The format when displaying text on a 
television is limited to a 40 character by 25 line display. A television set lacks the 
resolution necessary to display more than this amount of text on screen. Through 
the BIOS calls listed in Chapter 6, you can specify the mode of operation. Table 9-2 
summarizes those modes as used with the BIOS interrupt lOH. 


Table 9-2 

Modes of Video Operation 

BIOSINT10H 

Function Number: OOH = 

Set Mode 

Function Number: OFH = 

Read Mode 

Video Mode Contents of AL 

40 X 25 B/W 

OOH 

40 X 25 Color 

01H 

80 X 25 B/W 

02H 

80 X 25 Color 

OSH 

320 X 200 B/W Graphics 

04H 

320 X 200 Color Graphics 

05H 

640 X 200 B/W Graphics 

06H 


The color/graphics board contains 16K of memory, which stores alphanumeric 
video information in a manner similar to the monochrome board. Since the color 
adapter contains four times the amount of memory of the monochrome adapter, 
up to four pages of text can be stored in the memory of the color board when using 
the 80 by 25 display format, or eight pages of text when using the 40 by 25 format, 
as shown below. 


* 60 X 25 = 2000 characters, 2000 characters x 2 bytes = 4K, * 


* 

* 

* 


16K/4K 


4 pages, or screens, of text. 


•N* 

* 

* 


* 40 X 25 = 1000 characters, 1000 characters x 2 bytes = 2K * 

* 16K/2K = 8 pages, or screens, of text * 
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The BIOS functions presented in MACFLE.MAC and in this chapter demonstrate 
how to set the active page from the 4 or 8 possible pages in the adapter’s memory. 

Color 

Character Attributes 

The character attribute associated with each character is summarized in Table 9-3. 
You can specify any one of 16 colors as the foreground color (character color), and 
any one of eight possible colors as the background color. As you’ll see in a moment, 
the color attribute byte is slightly different depending on which of the two 
available graphic modes the adapter is operated in. Should you specify a black 
background and a white foreground, the attribute byte is similar to the mono¬ 
chrome attribute byte previously discussed. 


Table 9-3 

Color Attribute Byte 

B7 B6 B5 B4 B3 B2 

B1 BO 

B R G B 1 R 

G B 

Blink—1 1 1 

1 1 


1 1 

Background Color — | 

-Foreground Color 

(Possible 8 Colors) 

(Possible 16 Colors) 

IRGB-Color 


0000 = Black 


0001 = Blue 


0010 = Green 


0011 = Cyan 


0100 = Red 


0101 = Magenta 


0110 = Brown 


0111 = White 


1000 = Gray 


1001 = Light Blue 


1010 = Light Green 


1011 = Light Cyan 


1100 = Light Red 


1101 = Light Magenta 


1110 = Yellow 


1111 = White (High Intensity) 


Table 9-3 shows the color attribute byte used when displaying alphanumeric text 
with the color adapter. Also shown are the color combinations of the 16 possible 
colors encoded using the IRGB field of the attribute byte. 
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When the color adapter is operated in the graphics mode, the display is divided 
into a two-dimensional array of pixels (picture elements). The graphics resolution 
can be set to either medium resolution, providing for 320 by 200 pixels (64,000 
graphic points), or high resolution, offering 640 by 200 pixels (128,000 graphic 
points). The high resolution graphics mode has one drawback. You can display 
images in black and white only. There is not enough memory on the adapter to 
describe an attribute color along with 128,000 pixels. This is because 128,000 bits is 
equivalent to 16K bytes of memory, or all the memory available on the adapter. 


Medium Resolution 
Graphics Mode 

Table 9-4 summarizes the color combinations available in the medium resolution 
graphics mode. Any one of the 16 colors may be specified as the background color, 
while the foreground color must be from one of the two palettes shown. A total of 
four different colors can be displayed at any given time using the medium resolu¬ 
tion graphics mode of operation. 


Table 9-4 

Medium Resolution Color Combinations 

Background Color = Any of the 16 possible colors defined in Table 
9-3. 

Foreground Color = Palette 1: Cyan, White, Magenta. 

Palette 2: Green, Red, Brown. 

Shown are the color combinations available in the medium reso¬ 
lution video mode. To set the color palette, set the registers 
as follows: 

AH = Function number OBH. 

Register BH = OOH 
Register BL = OOH = Palette 2 
01H = Palette 1 

and execute BIOS interrupt lOH. 
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High Resolution 
Graphics Mode 


The high resolution mode of operation allows for a graphics display of 620 
columns by 200 rows of pixels. The main advantage to this mode is that the 
resolution is twice that of medium resolution. The disadvantage is that the high 
resolution screen does not allow the use of color. The only colors available are 
black and white. 

You can output text to the video display in either the high resolution or medium 
resolution graphic modes. If the characters output to the display are within the 
range of OOH to 7FH, the characters will be displayed on the graphics screen (see 
the ASCII chart in Appendix A for the character representation of each code). 


Pixel Positioning 


When specifying a pixel’s position on the screen in either high or medium resolu¬ 
tion modes, a row and column coordinate must be used. A medium resolution 
display consists of 320 columns by 200 rows, and the high resolution display 
consists of 640 columns by 200 rows. As an example of specifying a pixel’s 
position, examine the statements which make up the macro @SET in Listing 6-1. 

The macro’s body is comprised of the following instructions: 


MOV 

DX,RON 

;6et the row number (0~319 med. res.) 
•(or 0-639 in high resolution mode) 

MOV 

CX,COL 

;Set the column number <0-199) 

MOV 

PL,COLOR 

;Get the color of the dot 

MOV 

PH,0CH 

;B10S function code to set a pixel 

I NT 

10H 

;B10S interrupt. 


This function colors a pixel at the specified row and column. The function can be 
used to set or reset a pixel, depending on the color specified. If, for example, the 
mode was set to medium resolution, and you are working with a red background 
and specify the pixel’s color as red, the dot will disappear into the background 
color. However, if you specify the color to be brown, the dot will appear in the 
foreground on a red background. 

The color of the pixel when using the high resolution mode must be either black on 
black (OOH), white on black (07H), white on white (77H), or black on white (70H). 
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Working with BIOS 


Interrupt Type lOH 

By now you may feel that programming graphics and text is much too complicated 
and is better left to BASIC. You would be right and wrong if you felt this way. 
You’d be right, because the statements provided under BASIC are actually graphic 
subroutines that allow you to draw lines, circles, and rectangles. They are easy to 
use and quite efficient. Programming each pixel position on a high resolution 
screen containing 128,000 pixels is extremely tedious. 

This type of programming is repetitive and something that is ideally suited for a 
computer. If BASIC already contains the routines necessary to compute arcs and 
perform line drawing functions, why even contemplate writing Assembly Lan¬ 
guage graphic routines? The answer is speed. BASIC is too slow to perform 
animation or other graphic chores in a reasonable amount of time. 

Therefore, the BIOS functions that allow you to control the video display in both 
text and graphic modes are what you need to know about when creating high level 
graphic routines. These functions have been incorporated in the macro calls 
presented in MACFLE.MAC and are listed in Table 9-5. You should review these 
functions before continuing. 


Table 9-5 

BIOS Video Functions 

BIOSINT10H 

Function Number 

Function 

OOH 

Set Video Mode 

01H 

Define Cursor 

02H 

Set Cursor Position 

03H 

Return Cursor Position 

04H 

Return Light Pen Position 

OSH 

Set Active Page 

06H 

Scroll Screen Up 

07H 

Scroll Screen Down 

OSH 

Return Character Attribute at Cursor 

OOH 

Set Character Attribute at Cursor 

OAH 

Set Character at Cursor 

OBH 

Select Palette 

OCH 

Set/Reset Pixel 

ODH 

Return Pixel 

OEH 

Write Character 

OFH 

Return Video Mode 
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A Programming Example: 

GRAPHIC.ASM 


GRAPHIC.ASM (see Listing 9-1 in Appendix D) illustrates how higher level graphic 
routines can be constructed that approach the power and ease of use of graphic 
statements found in BASIC. Programming graphics in Assembly Language, and is 
usually a repetitive process. By writing programs or procedures capable of drawing 
a line, given start and stop values; or a circle, given the radius, aspect ratio, and 
center point; graphics programming becomes a pleasure rather than a chore. 

The program defines a procedure DRAW_LINE, which draws lines on the screen. A 
macro, ERASE, deletes a graphics line. The procedure and macro both require start 
and stop values for row (X-axis), and column values (Y-axis). A color must also be 
specified. The macro ERASE also uses the DRAW_LINE procedure. One procedure 
can serve to set or reset a range of pixels on the screen. 

Since the program uses the high resolution graphics mode, the only colors available 
are white and black. I used a black background and a white foreground when 
turning a pixel on, and a black background/foreground combination to turn the 
pixel off. The allowable values for row and column coordinates are 0-639 for the 
column, and 0-199 for the row. If the medium resolution mode were used in the 
program, the column values could range from 0-319, with a row value in the range 
of 0-199. 

Take a look at the program label START. After the segment registers are initialized, 
the program invokes a macro, ©VDMODERD, which uses the BIOS interrupt type 
lOH and the function number 6H to obtain the current video mode. The value 
returned in AL defines the current mode as follows: 

fiL = 0 = Text 40 X 25 B/W<EP> 

PL ~ 1 » Text 40 X £5 Color<EP> 

PL = £ = Text 80 x £5 B/W<EP> 

PL = 3 = Text 80 x £5 Color<EP> 

PL = 4 - Graphics 3£0 x £00 B/W<EP> 

PL = 5 = Graphics 640 x £00 Color<EP> 

PL = 6 = Graphics 640 x £00 B/W<EP> 

The active column number is in AH, and the active page is in BH. Whatever the 
mode and active column is, we want to save the value. Therefore, after the mode 
read function is invoked, the value returned in AX is saved on the stack. Since we 
are working with screen 0, the screen that was in effect, we will not save BX on the 
stack. Before the program terminates, the previous video mode will be restored. 
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Another BIOS function to set the video mode is now invoked (function 0, INT lOH). 
The video mode is set to the high resolution (640 by 200) black and white mode. 
Using the table just discussed, a value of 6 is moved into the AL register, which 
informs the function of the mode desired. The remaining portion of the main 
procedure initializes memory locations STARTX, STARTY, STOPX, STOPY, and 
COLOR before calling the procedure DRAW_LINE. These RAM locations define the 
characteristic of the line to be drawn. 

The procedure first draws a large A in the middle of the screen (program label 
DRAW_IT to DRAW_2). Next, a line is drawn from left to right on the bottom row 
of the screen. The program delays for about 1/2 second, then erases the line. The 
program again delays for 1/2 second before drawing a new line from the bottom left 
of the screen to the top left. This process is repeated in such a manner as to give the 
effect of a moving line creating a marquee around the border of the screen. 

This is the simplest form of animation. An object (a line, in this program) is drawn, 
erased, and redrawn somewhere else on the screen. More complex forms of 
animation account for more than one object and move more than one object 
around on the display simultaneously. 

After executing the border loop 40 times, the program invokes the macro 
©WAITKEY, which waits for a key to be pressed. Once a key is pressed, the 
program reinstates the old video mode of operation that was saved on the stack at 
the beginning of the program. The program terminates and returns to DOS. 

The DRA W_LI]VE Procedure- 

This procedure expects that the RAM locations STARTX, STOPX, STARTY, 
STOPY,and COLOR have been set up prior to calling the procedure. The routine 
automatically calculates the direction in which the line must be drawn. Since the X- 
axis coordinates begin with column zero on the far left of the screen and increase in 
value toward the right of the screen, the direction (with reference to the X-axis) 
that you want to draw the line is easily calculated from start and stop values for X. 
If, for example, the starting column value of X is 99 and the stop value for X is 174, 
the line must be drawn from left to right. If, however, the start value were 174 and 
the stop value 99, the line would be drawn from right to left. The direction can be 
calculated by subtracting the start value from the stop value. The direction of the 
move is from left to right if the result of the subtraction is positive (STOPX - 
STARTX > 0). Similarly, the direction is from right to left if the result of the 
subtraction is negative (STOPX - STARTX < 0). 

The direction the line is drawn along the Y-axis is calculated in an manner identical 
to the X-axis. The exception is that the values stored in RAM at STARTY and 
STOPY are used in the calculation. The row values begin with zero at the top of the 
screen and increase in value towards the bottom of the screen (see Figure 9-1). 
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COLUMN 319 



(Medium Res) 
(High Res) 


These calculations are carried out at the beginning of the procedure. The RAM 
location DIRECTIONX contains a zero value if the X-axis direction is calculated as a 
move from left to right across the screen (forward) or a nonzero value if the move 
should be from right to left (backward). The RAM location DIRECTIONY contains a 
zero value if the Y-axis move is calculated to be from the top of screen to the 
bottom (down), and a nonzero value if the move is calculated as a move from the 
bottom of the screen to the top (up). 

Once the direction values have been set, the procedure (at label D_L_3) begins to 
draw the line specified. The macro @SET is invoked to set the pixel at the X/Y 
coordinates specified and in the color specified. The contents of RAM locations 
STARTX, STARTY, and COLOR are the parameters used in the argument field of 
the macro. 

A byte in RAM (D_L_FLAG) informs the procedure whether all the values along 
either the X-or-Y axis have been exhausted. Bit 0 of D_L_FLAG is set when all the X 
values have been used, and bit 1 is set when all the Y values have been used. If, for 
example, there are 16 points to be graphed along the X-axis and 20 along the Y-axis, 
a line similar to that shown in Figure 9-2 will be drawn. 

The procedure continues to increment the contents of memory locations STARTX 
and STARTY until their values equal STOPX and STOPY, respectively. If the initial 
values of the start positions are larger than the stop positions, STARTX and 
STARTY are decremented until they equal STOPX and STOPY. The loop from label 
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COLUMN 

x-16 — 



D_L_3 to U_2 is executed until the start and stop coordinates are equal. The 
procedure then returns to the calling program. 

The ERASE Macro 

This macro erases a line by specifying the start and stop X/Y coordinates and a 
color combination of black on black. The foreground/background color combina¬ 
tion effectively erases the pixel specified by the X and Y values. Notice in the macro 
definition just prior to the code segment, a call is made to the procedure 
DRAW_LINE. The same procedure that is used to set a range of pixels can also be 
used to reset pixels. The only difference between setting and resetting a pixel is in 
the color code specified. White on black sets the pixel, and black on black resets the 
pixel. 

Going Further — ' 

Study the macros used in the program (see also MACFLE.MAC). When you under¬ 
stand how a line is specified and drawn, modify the program as follows: You may 
have noticed when running this program that the line drawn on the right-hand side 
of the screen is not flush with the rightmost column (639). Rewrite the portion of 
the program that draws this line, so that it is flush with the right side of the screen. 

This program should give you some ideas of how to automate the many routine and 
tedious tasks which are involved in creating what are known as graphics primi- 
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lives. Currently, there are no formal standards for graphics, although there are 
many proposals under study by the standards organizations. You might want to 
attempt to write a general purpose procedure to draw circles or some other 
geometric shapes. 

Anyone could have shown you how to set a pixel on the screen through BIOS 
interrupt lOH/function OCH. What I wanted to do was to go the next step in 
Assembly Language graphic programming, graphics primitives. 



Like graphics, MS-DOS also lacks functions to allow Assembly Language control 
over the internal speaker of the IBM PC. To produce sound that varies in frequency 
and tone, the 8255-A Programmable Peripheral Interface (PPI) chip must be 
directly accessed. This means you can’t create programs that can run on other MS- 
DOS machines, since you are not dealing with MS-DOS when you go directly to the 
chip to produce sound. The chances that a similar design exists in other MS-DOS 
machines cannot be guaranteed (although the COMPAQ computer does have a 
compatible design). 

The IBM Technical Reference Manual contains a description of the PPI bit assign¬ 
ments and the speaker interface circuit on pages 1-12 and 1-23. You can turn the 
speaker on and off by gating either the 8253 timer output to the speaker or by 
setting and resetting bit 1 of port B of the PPI at port 6lH. The port can be read to 
obtain the current setting of the bits for the B port of the chip. This value should be 
restored after your program is finished generating the sounds at the speaker. 

If bit 0 is set, the 8253 timer’s output is gated to the speaker. Bit 1 must also be set to 
enable the gating of the timer’s output to the speaker. In the program SOUND .ASM 
(see Listing 9-2 in Appendix D), the first method is used to generate sound via the 
internal speaker. 


The Data Segment 


The sound generating procedure expects a frequency and a duration to be specified 
in the RAM locations FREQUENCY and DURATION. The values in the table 
FREQUENCY_TABLE and DURATION_TABLE produce a series of tones of varying 
duration at the speaker. 
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The frequency table is one word larger than the duration table. I used OOOOH as a 
terminator word to the table. The program terminates on seeing the end of data 
value OOOOH in the frequency table. Therefore, frequency values of OOOOH are not 
allowed. 


The Code Segment 


The program starts by clearing the screen and displaying the message “Hit any key 
to begin SOUND!” The ©WAITKEY macro is invoked (see Chapter 6), which waits 
for a key to be pressed. 

After a key is pressed, the program moves one value each from the frequency table 
and duration table to the RAM locations DURATION and FREQUENCY. Once these 
locations are set up, the procedure SOUND_GEN is called. This procedure pro¬ 
duces the tone at the speaker. 

The pointers into the two tables are then adjusted, and the next value in the 
frequency table is compared for OOOOH. If found, the program terminates and 
returns to MS-DOS. If the value is not OOOOH, the program jumps back to the label 
NEXT_NOTE. 

Procedure: 

SOUND.GEN- 

Sound generation occurs by setting and resetting bits 0 and 1 of port 6lH. A delay is 
executed after setting the bits, and again after resetting the bits. This delay deter¬ 
mines the frequency of the note. The value stored at FREQUENCY determines the 
amount of time spent in the delay loops at FREQ_OUT and FREQ_OUT_2. The 
entire process is repeated by a count defined in DURATION. 

Interrupts are disabled at the beginning of the procedure and enabled prior to 
exiting the procedure. If this action were not taken, undesired interrupts could 
occur while the speaker is either on or off, causing the duration and the frequency 
of the tone to vary. The result would be an unstable tone, as the delays used in 
producing the tone would no longer be predictable. 

You can incorporate the SOUND_GEN procedure in your own programs. Simply 
set aside storage in your data segment for FREQUENCY and DURATION. Set these 
locations with the values desired and then call the procedure. 

In the next chapter. I’ll discuss the best of all worlds: MS-DOS, BIOS, chip level 
programming, and interrupts. All the concepts discussed thus far and some new 
ones will be demonstrated in a versatile data communications program. 
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1. BIOS is an acronym for: 


2. BIOS insures program compatibility through high level language statements. 
(True or False) 

3. How many pages of text can be stored using the 80 by 25 mode of the color 
graphics adapter? 

4. There are_pixels available using the high resolution video 

mode. 

5. The monochrome adapter uses a 320 by 200 medium resolution display. 
(True or False) 










IBM is perhaps best-known in the computer industry for its ability to have its may 
diverse computing devices communicate with each other. This is not easy to 
accomplish. This chapter introduces you to the world of data communications and 
how to write your own communication programs in Assembly Language on the 
IBM PC. 

I stated earlier that it is nearly impossible to program an application if you as the 
programmer do not possess a working knowledge of the application. I have 
refrained from including application specific programming examples thus far; 
however, in this chapter I will concentrate on a full-featured telecommunications 
program. 

There are several other books covering the subject of data and telecommunications 
more thoroughly than I can in this one chapter. Most notable are those from James 
Martin, whose books Telecommunications and the Computer znd Design Strategy 
for Distributed Data Processing, are listed in the bibliography of this book. Martin 
is a recognized authority on the subject of data communications, and I refer you to 
his books for further information on the subject. 

My intent in the first part of this chapter is to provide you with a background broad 
enough so that you will understand the terminology associated with data commu¬ 
nications. I encourage you to take this background information and the program¬ 
ming example in this chapter and improve upon both. 
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The second part of the chapter details how the programs COMM. ASM (Listing 10-1) 
and DLOAD.ASM (Listing 10-2) operate. These two listings can he found in Appen¬ 
dix D. To use the programs, type in the source listings. Notice that certain variables 
and program entry points are marked PUBLIC and EXTRN in each module. This 
allows each module to reference variables that are defined in the other. 

Once you have created the source files, use the IBM Macro Assembler to assemble 
the source modules into relocatable (.OBJ) modules. Once the object modules have 
been created, use the linker to link the files. To link the files type: 

COMM.OBJ + DLOnO.OBJ 

at the linker’s prompt. Name the executable output file COMM.EXE. 


Communications Protocol 


In order to communicate effectively, all the parties involved must agree on how 
the transfer of information is to take place. This set of rules is referred to as a 
communications protocol. Without it, neither party could effectively or efficiently 
communicate. I like to think of a communications protocol in terms of two people 
speaking different languages who are communicating without the ability to see 
each other. Imagine the problems involved in trying to ask the other person for a 
glass of lemonade. Without a protocol that has been agreed upon prior to commu¬ 
nications, you’d probably wait years to get your lemonade. A protocol must be 
defined. 

You must agree on the language you both will speak. If neither party is bilingual, 
you still have a problem. For computers, the most commonly used standard is 
ASCII, or the American National Standard Code for Information Interchange. 
ASCII is a 7-bit coded character set defining not only characters and number 
representation but also the use of control functions to facilitate the data transfer. 
Yet even with computers there may be a problem if they are expected to communi¬ 
cate in an international environment. Like you and your nonbilingual counterpart, 
they may require some type of code translator or a different protocol. 

Code translation is a problem. Although ASCII is one of the most widely used forms 
of data coding, there are other methods of coding the data for information inter¬ 
change. Telex uses the 5-bit Baudot code to represent data. IBM developed 
EBCDIC, which is still another code set. If you were using an ASCII terminal and 
wanted to communicate on a Telex network, code translation would be required. 
The 7-bit codes sent from an ASCII terminal to one expecting to receive 5-bit 
Baudot would fall on deaf ears (or modems), so to speak. Another potential 
problem exists when the data are exchanged in a character set that was previously 
agreed upon, such as ASCII, and there are differences in national usage of certain 
characters within the set. 
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When do you talk, and when does the other party talk? Or is one party only a 
listener (receive only, or RO) and never talks? For computers, this correlates to full 
duplex, half duplex, and simplex operation. Full duplex allows two parties to 
transmit data to each other simultaneously. Both may talk at the same time, and 
they are allowed to talk about totally different subjects (remember the last time you 
asked your boss for a raise?). Half duplex dictates that only one party can transmit 
at a time. When the first party is finished talking (or transmitting), the other party 
can begin transmitting data. Simplex is a one-way-only type of communications. 
Receive-only devices (printers) or send-only devices (keyboards) are typical of 
devices operated in a simplex mode (Figure 10-1). 


TERMINAL I 
TX/RX 



TERMINAL 2 
TX/RX 


FULL DUPLEX 


TERMINAL I 
TRANSMIT 
RECEIVE 



LINE 

TURN 

AROUND 



TERMINAL 2 

RECEIVE 

TRANSMIT 


HALF DUPLEX 


COMPUTER 


PRINTER 


SIMPLEX 


Figure 10-1 Full duplex, half duplex and simplex operation. 


There are several other specifics that should be included in the protocol. Will there 
be error checking? If so, what type? Imagine if you were asking the head of state of a 
foreign country for a glass of lemonade, and your translator conveyed the wrong 
information to him and told him he was a real lemon. If the translation contains 
only a minor error, it may go unnoticed. If it is a big blunder, you could cause an 
international incident. When your computer transmits data, an error-checking 
protocol, such as parity checking, checksums, or more advanced methods, may be 
employed to detect and even correct errors. Data integrity is extremely important 
in communications of any type. There are many more types of protocols, some of 
which ITl discuss later. 
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Methods of Data Transmission 


Computers are able to move data in and out of memory or to and from a peripheral 
device, such as a printer, over multiple lines. This type of structure is referred to as 
a bus and contains multiple signal-carrying lines that run in parallel (Figure 10-2). 
Parallel bus structures are an efficient way to move data around inside your 
computer and to devices that are connected locally to it. An advantage to parallel 
tr ansmis sion of data is that whole words, or bytes of information, are transferred at 
one time at very high speeds. 



Figure 10-2 Paralell transmission of data from a computer to a printer. 


Eight data lines transfer the character to be printed, and the STB signal is used to 
strobe the signal into the printer’s character buffer. When the printer’s buffer is full 
or the printer is busy printing characters, the RDY (ready) line is disabled, inform¬ 
ing the computer that the printer is not ready to receive any more characters. 
When the computer senses the RDY signal to be true, further data transfers will 
commence. 

Each parallel line of the bus corresponds to a single bit of information of the data 
being transferred. A system can have more than one bus. Data, address, and control 
bus structures can all coexist as independent structures within the system. 

When there is a long distance between the computer and an auxiliary device, 
parallel transmission of data becomes impractical. Being susceptible to noise, each 
signal also suffers from transmission line reflections, distortion, and line loss. The 
physical limitations of the medium (eight or more wires, as opposed to two for 
serial transmission) and the required in-line amplification to compensate for signal 
loss present a justification for a different type of transmission over long distances. 
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It’s also more costly to run eight or more lines than it is to run only two wires over a 
long distance. 

Even communicating between the computers I own, demonstrates the advantages 
of serial versus parallel communication paths. One of my computers is in my 
downstairs office, while the other is located on the second floor. The physical 
length of the transmission path is less than 20 feet, yet serial communications gives 
me the advantage of running only three wires as opposed to eight or more. I only 
need one wire for the transmit data wire, one for the receive data, and a ground. 
This is one of the simplest cabling schemes for serial communications, as you will 
see when we investigate the RS-232C serial interface standard later in this chapter. 

In serial communications, each bit of the data word is transmitted in succession, 
with the LSB (least significant bit) transmitted first. This is done so over one wire 
(there is another wire for common ground). As shown in Figure 10-3, a character is 
transmitted in an asynchronous format by first sending what is known as a start bit 
to the receiving terminal. The start bit enables the receiving terminal to recognize 
the character bits which follow. The data are transmitted a single bit at a time. In 
Figure 10-3 the 7-bit ASCII letter N is being transmitted. The character is framed 
with start, stop, and parity bits. 
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Figure 10-3 An example of serial data transmission. 
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Bit 0 is the first bit of the character to travel down the line to the receiving terminal. 
It is followed by bit 1, bit 2, bit 3, bit 4, bit 5, and bit 6. Bit 7 would follow if the data 
word were 8 bits long, instead of 7 bits. An optional parity bit can be specified as a 
part of the protocol and follows the data when parity is enabled (see parity 
discussion later in this chapter). 

As data are transmitted one bit at a time, serial communication is slower than 
parallel transmission. The main advantage is the reduced cost of the transmission 
system and wire required to carry the signals. Additionally, serial communications 
lends itself nicely to transmission over common carrier networks such as the 
phone system or Telex network, whereas parallel communication does not. Your 
telephone does not have eight wires associated with transmitting voice over the 
network, it has only two or four wires. Therefore, it preludes the use of parallel 
transmission of data. 


TheUART 


A device known as a UART (Universal Asynchronous Receiver Transmitter) con¬ 
verts the data received in parallel from the computer’s bus to serial format required 
for telecommunications. The UART is a fairly sophisticated device which allows a 
great amount of flexibility in the character formats used in communications. 

The UART is actually a dedicated microprocessor which has been designed to 
handle the communications interface and protocol. The UART is an integrated 
circuit consisting of a number of registers that are programmed to carry out the 
desired communication functions. The UART used on the Asynchronous Commu¬ 
nications Adapter (ACA) in the IBM PC is the National Semiconductor INS 8250. 

Table 10-1 lists the register ports of the ACA in the IBM PC. Programming the chip is 
fairly straightforward and is done for you initially by BIOS. However, you will 
have to establish the communications parameters as required by the specifics of 
your communications protocol. BIOS provides you with the necessary functions 
to accomplish this. I’ll discuss protocol specifications in more detail when the 
programming example is presented. 


Telecommunications 


The serial bit stream from your computer, which is in digital form, must be 
converted to audio tones for transmission over the telephone system (Figure 10-4). 
Originally designed to handle only voice, which is in analog form, the conversion 
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Table 10-1 

Serial Board Port Assignments 

Port address assignments for the optional serial I/O (RS232C) 
boards found in the IBM PC. 

Function 

I/O 

Board Number 1 Board Number 2 

Transmitter 

Holding 

Register 

OUT 03F8H 

(Bit 7 of the line control register = 

02F8H 

0) 

Receiver 

Holding 

Register 

IN 

03F8H 

02F8H 

Baud Rate 
Divisor (LSB) 

OUT 03F8H 

(Bit 7 of the line control register = 

02F8H 

1) 

Baud Rate 
Divisor (MSB) 

OUT 03F9H 

(Bit 7 of the line control register = 

02F9H 

1) 

Interrupt 

Enable 

Register 

OUT 03F9H 

(Bit 7 of the line control register = 

02F9H 

0) 

Interrupt 

Identification 

Register 

IN 

03FAH 

02FAH 

Line Control 
Register 

OUT 

03FBH 

02FBH 

Modem Control 
Register 

OUT 

03FCH 

02FCH 

Line Status 
Register 

IN 

03FDH 

02FDH 

Modem Status 
Register 

IN 

03FEH 

p2FEH 


process is still a prerequisite to communicating data over most telephone circuits. 
The conversion is performed by a device called a modem. These frequencies (or 
tones), relate to the data’s binary equivalent, binary 1 or 0. The U.S. frequency 
assignments are shown in Table 10-2. By dividing the audio spectrum into separate 
frequency assignments, two-way communications over a single wire may take 
place. 
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DIGITAL 



Figure 10-4A Digital to analog conversion of data via modems for transmission of data over common 
carrier facilities such as the telephone network. 



VOICE GRADE BANDWIDTH 


Figure 10-4B Range of audio frequencies allowed over the telephone network (voice bandwidth). 
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Figure 10-4C Typical method of converting an analog signal to digital form is through the use of an 
Analog to Diaital Converter (A/D or ADC). 
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Table 10-2 

U.S. Frequency Assignments 

Standard 

Baud 

Modulation 

Type 

Transmit 
Space Mark 

Receive 
Space Mark 

Bell 103 

300 

FSK Full Duplex 

1070 

1270 

2025 

2225 

Bell 113 

600 

FSK Full Duplex 

1070 

1270 

2025 

2225 

Bell 202 

1200 

FSK Half Duplex 

2200 

1200 

.... 

.... 

Secondary 

Channel 

5 



387 

Originate 

.... 

Answer 

Bell 212 

1200 

PSK Full Duplex 

1200 

2400 

2400 

1200 


Also shown in Table 10-2 are the modulation type and duplex mode. For the Bell 
212 modems, the modulation rate is half of the baud rate shown (e.g., 600), due to 
dibit encoding of the data. All transmit and receive frequencies are in hertz. (Table 
based on information found in Bell publications). 



Analog signals are said to have a continuous range of possibilities, whereas a digital 
signal has two discrete possibilities. Figure 10-5 shows a typical analog signal, a sine 
wave. When used to communicate data, the sine wave is modulated by the data. Its 
amplitude, frequency, and phase are all capable of being modulated. Figure 10-6 
shows the three fundamental types of modulation. 



Figure 10-5 
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Figure 10-6 The three most common modulation techniques in use today. From top to bottom, 
amplitude modulation (AM), frequency modulation (FM), and phase modulation (PM). 
(Illustration based on the works of James Martin). 


Frequency Modulation (FM) 


Frequency Shift 

Keying (FSK)- 

FSK is a mode of FM whereby data is transmitted over telephone circuits by shifting 
the carrier frequency in response to a binary 1 or 0. The logic level (1 or 0) is 
determined by the data being sent. By allowing one frequency to designate a mark 
(binary 1) and another to designate a space (binary 0), digital data can be transferred 
from one point to another. The data is modulated at the sending terminal and 
demodulated by the receiving station. FSK is also referred to as FI, F2 transmission. 


Phase Modulation (PM) 


Phase modulation is used in higher speed transmissions (typically 2400 to 4800 
bps). The phase of the waveform changes in response to binary 1 or 0. Table 10-3 
depicts what is known as dibit phase encoding. Two bits are grouped together, 
dictating the number of degrees the carrier will change in phase. Receiving equip¬ 
ment interprets the phase shift and reinstates the proper binary grouping. Phase 
encoding is also used to group more than two bits together in transmission. 

A grouping of 2 binary digits causes the carrier wave to shift in phase by the 
specified number of degrees. By grouping multiple bits of information to each 
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Table 10-3 

DIBIT Encoding and Phase Modulation 

2 bit binary grouping Phase Shift (degrees) 

(DIBIT) 

0-0 

90 

0-1 

0 

1 -0 

180 

1-1 

270 


signal change, the modulation rate, or baud rate, can be lower than the total 
number of bits transferred in one second. 


Amplitude Modulation (AM) 


This technique varies the amplitude (voltage or current) of the carrier wave in 
response to the binary data. We are all accustomed to hearing this term used in 
conjunction with AM radio stations. The same technique is applied in data commu¬ 
nications. Amplitude modulation requires more power and is more susceptible to 
noise than the two methods previously discussed. 

Another aspect of the AM signal is the bandwidth, or range of frequencies the signal 
must occupy. For voice, the highest frequency used in telephony is approximately 
3400 hertz (see Figure 10-4). A characteristic of AM signals is the generation of 
sidebands, or new frequencies formed by the mixing of the carrier wave and the 
modulating tone. Sidebands are created that are the sum and the differences of the 
modulating waveform. Therefore, the total bandwidth of an AM signal modulated 
by a voice is 8000 hertz, or twice the highest frequency used to modulate the 
carrier. AM systems are usually not employed in data communications. 



Full Duplex 


On a full-duplex communications channel, data transfers are allowed in both 
directions simultaneously. A four-wire circuit is most often used for full-duplex 
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operation. Two wires carry data in one direction, while two others carry data in 
the opposite direction. Two-wire systems can be used if the audio spectrum is 
partitioned to provide separate receive and transmit frequencies. Figure 10-7 
demonstrates how transmission over a 2-wire circuit takes place. 
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TX 


SPACE = 2025Hz ^ - 
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Figure 10-7 Full-duplex frequency assignments. By segmenting the available bandwidth of a given» 
communications channel, a single wire can be used for full-duplex communications. 


The transmit frequencies for the originating terminal are the receive frequencies 
for the answering terminal. The receive frequencies for the originating terminal are 
the transmit frequencies of the answering terminal. Bandpass filters restrict the 
bandwidth of each station’s receiver, preventing one station from listening to its 
own frequencies. One station (or modem) must assume the originate mode, while 
the other terminal assumes the answer mode. If both stations were set to answer or 
both were set to originate, no information would be transferred. 
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Half Duplex 


Half duplex is a communications mode whereby only one party can transmit at a 
time. When the transmission is complete, the other party can transmit, while the 
first can only receive. In order to accomplish true half-duplex communications, 
the transmission line must be turned around when it is the other party’s turn to 
transmit. Line turnaround can take 250 milliseconds or more; therefore, the line is 
not utilized to its fullest capacity. Remember full duplex allows simultaneous 2- 
way transmission, without the need to turn the line around. There is no dead time 
while the transmission line must be turned around. Full-duplex operation, there¬ 
fore, uses the transmission medium in a more efficient manner. The frequencies 
used in half-duplex and simplex operation are shown in Figure 10-8. 

When operating a half-duplex channel, each terminal may locally echo each 
character it transmits. Local echoing to a CRT or printer is common in half-duplex 
systems. Since only one station is allowed to transmit at a time, there is no echoing 
of characters from the receiving terminal. It cannot transmit until the sending 
station is finished. Without a local echo option when communicating over a half¬ 
duplex channel, you would never see the characters you were transmitting. 
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Figure 10-8 








Communications 281 


In full-duplex operation, the host or main computer often echoes the characters 
back to your terminal as it receives them. If your terminal were to provide local 
echo, two characters for every one transmitted would appear on your CRT, the 
one the remote terminal sent back to you and the one your local echo function 
provides. 


Simplex 


Simplex operation (Figure 10-9) is a one-way-only data link. Two examples of 
simplex operation are line-of-sight communications and television signals that are 
broadcast to a satellite and retransmitted to a ground or earth station (receiver). 
Each path of the data link is one-way-only and constitutes a simplex channel. 
Keyboards, printers, and other receive-only or send-only computer peripherals are 
examples of simplex devices you may be more familiar with. 



Figure 10-9 
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Asynchronous 

Communications 


Asynchronous transmissions are data transmissions which do not require a sepa¬ 
rate clock or other timing element to be sent by one terminal to synchronize 
reception by the other. Asynchronous communications are typically irregular 
(characters are transmitted on an irregular basis such as from a keyboard) and 
framed by a start and stop bit. Each character, as it is transmitted, has a start bit 
inserted in the data stream before the first bit (bO) is sent. After the last bit of the 
data word is sent, a stop bit of a specified interval is inserted. 

During idle line conditions (when no characters are being transmitted), the line 
assumes the marking state, which is equivalent to a binary 1. The start bit is the 
reference element that notifies the receiving terminal a character is being transmit¬ 
ted. Being opposite that of the idle line condition, or binary 0, the start bit assumes 
what is known as the spacing condition. The receiving terminal interprets the data 
bits following the start bit as character data and looks for a valid stop bit designat¬ 
ing the end of transmission. The stop bit may be of variable length. 

For example, in 5-bit Baudot, the stop bit is 1.5 bits in length. It occupies one 
complete bit timing cell and half of another bit cell to signal the end of the 
character. This is the minimum amount of time the transmission line must be held 
in a marking condition between characters. If another character is not ready to be 
sent, the line is returned to idle and remains in the marking state until the next start 
bit occurs. 

A disadvantage to asynchronous communications is its inefficiency when com¬ 
pared to synchronous forms of transmission. Since two or more extra bits are 
required in the transmission of each character, a great deal of time is spent sending 
framing information and not the actual data. For example, if transmitting standard 
7-bit ASCII, with parity checking enabled and, with 1 start and 1 stop bit, 3 out of 
every 10 bits would be used to convey timing and error-checking information. That 
is, 30 percent of every character transmission time is used for supervisory func¬ 
tions. 
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Synchronous 

Communications 


Synchronous communications can be thought of as a block oriented data transfer 
technique. An entire block of data is transferred at a time, instead of a single 
character as in asynchronous communications. Because transmissions occur with¬ 
out framing every character with start and stop bits, communications are faster and 
the transmission is more efficient. 

Sending and receiving parties must be synchronized whenever communications 
are to occur. Since the data words or characters are not framed by synchronizing 
bits, the entire block being transferred is framed by synchronizing characters or 
flag characters. A clock or timing character must be transmitted when the line is 
idle to keep the communicating terminals in synchronization. 

The ASCII control code SYN is often used to begin a frame or block of data. When 
the line is idle, SYN (SYNchronize) is transmitted. This control code allows the 
receiving terminal to synchronize to the data frame that follows. It starts a clock in 
the modem or receiver of the receiving terminal, which locks in on the control and 
data characters, or bits following the SYN character. An example of a synchronous 
frame is shown in Figure 10-10. 


FI 

A 

c 

T 

BCC 

F2 


TEXT BLOCK 


CONTROL 
ADDRESS 
► OPENING FLAG 


FRAME CHECK 


CLOSING FLAG ◄- 


Figure 10-10 A frame of information as formatted by synchronous data line control communications. 


Each frame begins with an 8-bit flag sequence of binary 01111110. The frame ends 
with a flag of the same binary representation. The address and control fields are 
each 8 bits in length. The text block must be a multiple of 8 bits and is followed by a 
frame check sequence that is 16 bits in length. The frame ends with an 8-bit flag 
sequence. 
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The frame is divided into fields, each carrying specific information about the text 
or the communications in progress. For example, a header may precede the text 
that not only contains the SYN character but also may contain address information, 
the length of the block being transmitted, and a block number identifying which 
block in a series of blocks is being transmitted. 

The trailer usually contains error-checking information, such as a checksum which 
is generted on the body of the block or a Cyclic Redundancy Check (CRC) of the 
block. It may also contain a closing byte or flag. SDLC opens a block with the binary 
flag 01111110 and closes the block with the same flag. 

The receiving terminal keeps track of the current block number and verifies the 
error-checking codes received in the frame. If it detects an error, such as the wrong 
checksum, it sends a Negative AcKnowledgement (NAK) to the sending terminal. 
The NAK may be in the form of a block, complete with header and BCC, or the 
ASCII control code NAK may be all that is sent to the other computer. 

The NAK tells the other terminal to retransmit the last block (or blocks) of informa¬ 
tion, because they were received in error. However, if the receiving computer 
signals back with the control code ACK (ACKnowledgment), it is saying that it 
found no errors, and it agrees with the checksum or CRC that was received. This 
handshaking continues until all blocks are transferred. Usually the code EOT (End 
Of Text) signals the end of the transfer. 

There are several high level protocols associated with synchronous block oriented 
data transfers. They also provide more sophisticated error checking than parity 
checking allows for in asynchronous communications. Some of the more popular 
synchronous protocols in use today are HDLC (CCITT and ISO recommendations), 
ADCCP (Advanced Data Communications Message Protocol, defined by ANSI), 
BISYNC (Binary Synchronous Communications Protocol), SDLC (Synchronous 
Data Link Control, developed by IBM), and DDCMP (Digital Data Communications 
Message Protocol, developed by Digital Equipment Corp.—DEC). 

SDLC is a bit oriented protocol. The individual bit positions within the frame take 
on significance as to the information they represent. Bits 0-7 are always the 
opening flag character, and bits 8-15 always contain address information as to the 
frame’s origin or destination. The significance these bit positions represent never 
changes when using this protocol. Other protocols may be classified as byte or 
character oriented in nature. 

Since a block of data can consist of multiple bytes, or characters, and framing 
occurs only once for each block, line efficiency is increased over asynchronous 
protocols. As an example, let’s pick a block length of 1024 characters each consist¬ 
ing of 7 bits (7168 bits). If we assume 16 bits for beginning and ending flags, 16 bits 
for the address and control fields, and a l6-bit frame check sequence, only 48 bits of 
the total 7,216 bits are used for control information. Only .66 percent is spent 
sending framing and nondata oriented information. 





Communications 285 



Baud rate is probably the most misunderstood term in telecommunications. What 
baud rate describes is the modulation rate of the data being transferred. It is usually 
equated with data being transferred in Bits Per Second (BPS). Baud rate actually is 
equal to the total number of signal elements per second. If 300 signal elements are 
sent in one second, you are transmitting at 300 baud. 

There are other techniques in data communications that allow more than 1 bit to be 
transmitted each time the signal changes. Therefore, the baud rate could be less 
than the bits per second. By grouping binary digits into dibits and using phase shifts 
to modulate the carrier, each signal change would correspond to 2 bits. The baud 
rate would be half the bps rate of the transfer. Table 10-3 illustrates the use of dibit 
encoding to phase modulate the carrier. 

Baud rate can only be equated to bits per second when a single binary digit (bit) 
corresponds to a change in signal. In most low speed communications (300 bps to 
1200 bps), the modulation technique used is FSK (Frequency Shift Keying), where 
bps is equal to baud. 



With any type of communications, error checking is extremely important. If the 
ability to insure the data integrity of the channel is left to chance, it could easily 
ruin or seriously degrade our communications capability. Noise is an ever-present 
companion to any electrical signal. Not only are transmitted signals susceptible to 
noise, they also are a source of noise to other transmissions. 

This type of noice source is commonly referred to as crosstalk. It’s evident when 
you place a telephone call to your long-lost brother, and you can clearly under¬ 
stand another conversation being carried on another circuit. A signal generated 
from another source is interfering with signals generated by you and your brother. 
Noise on telephone circuits can be caused by telephone switching gear, atmo¬ 
spheric conditions, or circuits in close proximity to each other. The faster the data 
transfer rate, the more bits or characters will be lost due to noise. 
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Another type of noice source is the impulse or random source. It can he likened to a 
noisy car randomly driving by your house (see Figure 10-11). If, in the middle of a 
conversation you’re having with a neighbor, the car backfires, a portion of the 
conversation may be lost. If the car suffers from some other abnormality, such as a 
missing muffler, many words may be lost. In data communications, this type of 
impulse noise is referred to as burst noise. The higher the communications rate, the 
more serious the problem. Rather than losing one or two bits (words, in our human 
to human analogy), entire characters may be lost due to bursts of noise on a data 
communications channel. 


COMMUNICATIONS 

RATE 


YOU KNOW ! BILL, j MY COMPUTER WAS DOWN (LOWSPEED) 


YOU KNOW BILL, MY COMPUTER WAS DOWN 


(HIGH SPEED) 


• LOST DATA 



^PANCj— — IMPULSE NOISE 



LOST DATA (3 BITS) 




COMMUNICATIONS 

RATE 


(LOW SPEED) 


RJUinnjuiv^Awi^^ (HIGH SPEED) 


V 


LOST DATA (6 BITS) 


Figure 10-11 
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There are other contributing factors to the degradation of transmitted signals aside 
from the noise that affects communications. Electrical properties of the transmis¬ 
sion medium can distort the signal to a point where it is rendered useless. Signal 
repeaters capable of regenerating the signal must be located at reasonable distances 
from the transmitting source. When the signal is regenerated, the signal’s level 
(amplitude), phase, and frequency characteristics are restored, noise is removed, 
and the signal is retransmitted to the next repeater or to the final destination. 


Parity 


Parity is an error-checking technique associated with asynchronous communica¬ 
tions. It is an optional bit inserted into the data stream that is dependent on the total 
number of bits set to a logic 1 in the data word. The total 1 bits, therefore, may be an 
odd or even number. 

The examples shown in Figure 10-12 demonstrate how parity is determined. If odd 
parity is being used, the total number of logic 1 bits must be an odd value. 
Conversely, the total number of logic 1 bits must be even if even parity is used. 

When parity is enabled in asynchronous communications, the total number of 
binary ones that occur within the word must be even or odd. The state of the parity 
bit is dependent upon the parity type you choose. It is set to a binary one whenever 
the total number of binary I’s in the word does not equal the parity mode (even or 
odd) that you have chosen. Examples are shown for both even and odd parity in 
Figure 10-12. 

Assume for a moment you are communicating with odd parity. The binary repre¬ 
sentation of the ASCII letter A is 10 0 0 0 01. There is an even number of binary ones 
in the code; therefore, the parity bit would be set to a binary 1 to make the total an 
odd number. The ASCII representation for the letter C is 1 0 0 0 0 11 (43 hex) and 
contains an odd number of binary ones. Thus, the parity bit is reset to zero for this 
character. 

Some terminals use what is referred to as marking or spacing parity. In this case the 
parity bit is always set to a mark or space. It will never vary. 


ASCII 

Character 

Binary 

ODD 

Parity Bit 

EVEN 

A 

1000001 

1 

0 

B 

1000010 

1 

0 

C 

1000011 

0 

1 

D 

1000100 

1 

0 

E 

1000101 

0 

1 


Figure 10-12 Examples of the use of parity 
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Other error-checking techniques are more elaborate. A Cyclic Redundancy Check 
(CRC) is often appended to a synchronous frame. The CRC is generated by multi¬ 
plying the transmitted data against a known polynomial. I refer you to the bibli¬ 
ography for additional reading material on higher level error-checking and 
correction techniques. 



Modem stands for MOdulator/DEModulator. A modem modulates or demodulates 
an analog signal for data communications. The telephone system is designed to 
accept an analog signal (your voice) and transmit it to a central office for further 
conditioning before sending it on to the party at the other end of the line. Being 
analog in nature, the system requires the data be converted from your computer’s 
digital signals into analog form before it is transmitted over common carrier lines. 
The modem does this. 

Most low speed modems (up to 1200 bps) use Frequency Shift Keying (FSK) to 
translate digital binary to audio frequencies within the bandwidth of the tele¬ 
phone. The telephone company limits the bandwidth allowed for voice transmis¬ 
sions over the switched public network to between 300 and 3400 hertz. By using 
different frequencies within this spectrum, each modem is able to generate or 
recognize a binary 1 or 0. Table 10-2 shows the accepted US standard frequencies 
for binary transmission. 

By dividing this band into smaller bands of frequencies, two-way transmission can 
occur over a two-wire system (one wire for signal transfer and one wire for 
common ground). The operating mode of each modem (originate or answer) 
dictates which set of frequencies is used for transmit and receive. 

The frequencies are termed mark (binary 1) and space (binary 0). The sending 
modem modulates the carrier by shifting its frequency, in response to the binary 
equivalent presented to its transmit data input. The receiving modem demodulates 
the signal by converting the frequency shift to the binary equivalent required by 
your terminal. 

Most modems are interfaced to a computer or terminal by connection to an 
RS-232C interface. This interface is a well-defined standard for interconnecting 
Data Terminal Equipment (DTE) and Data Circuit terminating Equipment (DCE). 
Recently, there has been a number of computers boasting of internal, or Direct 
Distance Dial (DDD), modems. All that is required is to connect the telephone cable 
to the RJ-11 jack of the computer. The modem is built into the unit, as is the 
telephone interface. Single chip modems are now available from a number of 
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manufacturers. Texas Instruments, Motorola, and Advanced Micro-Devices pro¬ 
duce single chip modems. The chips still require support circuitry, such as FCC 
approved data access arrangements, which connect the modem to the phone. 

An acoustic coupler is an interface consisting of a modem, but it is coupled to the 
telephone system acoustically. It contains a microphone and speaker that interface 
to the telephone without any wires being connected to the system. Most acoustic 
couplers operate at 300 baud of less, but there are some available that allow 
operation at baud rates of up to 1200 baud. To establish a call using an acoustic 
coupler, first the call is manually dialed. When the answering totals heard through 
the telephone receiver, the handset is placed into the cradle of the coupler, and the 
coupler is placed in originate mode. The microphone and speaker of the coupler 
transmit and receive the frequencies required for transmission to and from the 
handset acoustically. 


The RS-232C Standard 


The RS-232C Standard (International Standards CCITT V.24 and V.28), developed 
by the Electronics Industry Association (ElA), defines pin assignments for the 
connection of Data Terminal Equipment (DTE) with Data Circuit terminating 
Equipment (DCE). The standard defines the electrical, mechanical, and func¬ 
tionality of interconnecting circuits. Copies of the standard may be purchased 
from the EIA at 2001 Eye St., N.W., Washington, D.C. 20006. 

Table 10-4 contains the signals and pin numbers where the signals appear on a 
standard RS-232C connector. Although the niost popular connector is the DB-25 
connector (as used on the IBM PC asynchronous communications adapter), the 
standard does not specify the actual connector to be used. The international 
standard IS2110-1980 does specify the 25-pin connector and pin assignments. In 
their forward to the RS-232C standard, the EIA points out there are some incom¬ 
patibilities between the RS-232C and the ISO (International Standards Organiza¬ 
tion) standard. 

Whatever connector is used, the signals should be used in a uniform manner and 
appear on the designated pins. You should also be aware that the received line 
signal detector signal is commonly referred to as Carrier Detect (CD). It signals to 
the DTE that a carrier has been detected by tbe DCE. If the signal is in the off state 
(mark), then the DCE is either not receiving a valid carrier, or it is receiving one 
unsuitable for demodulation. 

Table 10-5 contains the electrical and logical conditions the circuits assume. Inter¬ 
change voltage refers to the voltage present at the interface connector pin for a 
given circuit. For example, the circuit DTR (Data Terminal Ready) is on pin 20 of 
the connector. The standard defines the circuit as being active (on), when the 
voltage is positive (between -F3 volts and -1-25 volts). DTR would be in what is 
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Tabie10-4 

RS232C Signal and Pin Assignments 

Reprinted with permission from the ElA’s RS-232C standard. 

Pin Number Circuit 

Description 

1 

AA 

Protective Ground 

2 

BA 

Transmitted Data 

3 

BB 

Received Data 

4 

CA 

Request To Send 

5 

CB 

Clear To Send 

6 

cc 

Data Set Ready 

7 

AB 

Signal Ground (Common Return) 

8 

CF 

Received Line Signal Detector 

9 

- 

(Reserved for Data Set Testing) 

10 

— 

(Reserved for Data Set Testing) 

11 

— 

(Unassigned) 

12 

SCF 

Sec. Rec’d. Line Sig. Detector 

13 

SCB 

Sec. Clear To Send 

14 

SBA 

Sec. Transmitted Data 

15 

DB 

Transmission Signal Element 

Timing (DCE Source) 

16 

SBB 

Secondary Received Data 

17 

DD 

Receiver Signal Element Timing 
(DCE Source) 

18 

— 

Unassigned 

19 

SCA 

Secondary Request To Send 

20 

CD 

Data Terminal Ready 

21 

CG 

Signal Quality Detector 

22 

CE 

Ring Indicator 

23 

CH/CI 

Data Signal Rate Selector 
(DTE/DCE Source) 

24 

DA 

Transmit Signal Element Timing 
(DTE Source) 

25 

— 

Unassigned 


termed as the spacing condition, with a binary equivalent of 0. When put in the 
marking state, the circuit’s voltage is negative (- 3 volts to - 25 volts), the binary 
equivalent of 1. All signals follow this convention. Furthermore, the drivers associ¬ 
ated with each signal must be able to withstand short-circuit conditions on their 
outputs. 

Using the IBM PC as an example (see the IBM Technical Reference Manual), DTK is 
presented to the DB-25 connector through U12, an RS-232C driver. The driver 
performs a voltage shift and inversion on the TTL level data presented to its input. 
Therefore, to properly set DTR to the active condition on this computer, it is 
necessary to set the control bit for DTR to TTL logic 0 (0 volts). Due to the voltage 
translation and inversion (0 volts to -t-12 volts) of U12, the signal is in the spacing or 
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Table 10-5 

RS232C Signal Functionality 


Notation 

Interchange Voltage 

Neaative Positive 


Binary State 

1 

0 


Signal Condition 

MARKING 

SPACING 


Function 

OFF 

ON 



on condition. If a logic 1 is output to the driver, the circuit assumes the off 
condition. Table 10-6 depicts signals used on the IBM PC for data communications. 

Terminals can communicate up to 50 feet using the RS-232C interface and at speeds 
up to 19,200 bps. I’ll discuss the RS-232C and its implications in the following text. 
You are advised to write to the EIA at the address given above and obtain copies of 
the standard. Related EIA interface standards are the RS-422, RS-423, and RS-449. 
The RS-449 standard permits transmission speeds up to 2 million bits per second 
and cable lengths of up to 60 meters. 


Table 10-6 

IBM PC RS-232C pin assignments 
Pin Number Signal 


1 

PGND 

(Protective Ground) 

2 

TD 

(Transmit Data) 

3 

RD 

(Receive Data) 

4 

RTS 

(Request To Send) 

5 

CTS 

(Clear To Send) 

6 

DSR 

(Data Set Ready) 

7 

SGND 

(Signal Ground) 

8 

CD 

(Carrier Detect) 

20 

DTR 

(Data Terminal Ready) 

22 

Rl 

(Ring Indicator) 


Figure 10-2 depicts the RS-232C signals used in the IBM PC. 


Computer to Computer 
Communications 


Most of the previous discussions have revolved around communications over the 
telephone. Computer to computer communications are also possible with the same 
software used for telecommunications. A special cable is required to interconnect 
two computers using the RS-232C interface. The term null cable is used to refer to 
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such a cable. In a null cable, pins 2 and 3 (TD and RD) are exchanged (see Figure 
10-3). Other signals may need to be tied together, such as DTR with DSR and RTS 
with CTS at each connector. Depending on what the software requires (i.e., CTS 
active, etc.) to allow communications, these signals or others are usually tied to 
their counterparts at the connector of each terminal to give the appearance of 
functionality to the software. 

For example, connecting CTS to RTS at one terminal would give the appearance of 
CTS being true. RTS is the signal the terminal would be sending to a modem if one 
were connected. CTS would be the signal returning to the terminal from the 
modem. By tying these two signals together, the terminal, on activating RTS, 
would see CTS being returned, or also in the on condition. Nearly every applica¬ 
tion is different, requiring different signals of the RS-232 to be present to fool the 
terminal’s software. 

Not all communications programs fully utilize all of the signals provided by the 
RS-232C. Referring to Table 10-6, you’ll see that not all of the RS-232C signals are 
brought into the IBM PC. All of the signals are not required for most communica¬ 
tions. Even the signals available are not all used in all communications software. 

Figure 10-13 shows a wiring diagram for a null modem cable that can be used to 
transfer data between two computers. By using the cable and the appropriate 
software, the two computers are able to share information and resources, such as 
disks and printers. You are restricted to a communications distance of less than 50 
feet when communicating through the RS-232C. This is not usually a problem, but 
you should be aware of the limitations of the standard. Other communications 
standards define communicating distances up to 4000 feet. (RS-422). 



As you can see from the source listing of COMM.ASM in Listing 10-1 (Appendix D), 
the program is broken down into small modules. This allows you to change or 
adapt the modules relatively quickly if more features are desired or the system’s 
hardware or operating system should change. COMM.ASM uses several system calls 
within its framework. Should changes occur to the operating system, COMM.ASM 
can easily adapt to its new environment. 

Because the program consists of many modules, it is necessary to provide you with 
some introductory material on how the modules interact. Some are used only to 
change an operational parameter, as in the terminal characteristics of the program. 
Still others are integral parts of the program that are executed on every pass of the 
job list. 
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DB - 25 CONNECTOR 


RS232 RS232 



Why Not MS-DOS 
Serial I/O? 


Two methods that can be used to receive and transmit characters via the 
asynchronous communications adapter are BIOS and MS-DOS function calls. The 
third method deals directly with the communications port and reduces the por¬ 
tability of the program to other MS-DOS computers. While it may not always be 
desirable to bypass the operating system and deal directly with the port, useful and 
sophisticated communication programs must be written in this manner. 

As I stated in the last chapter, the functions provided under MS-DOS for serial I/O 
are minimal at best and not well suited for generalized communications. Since MS- 
DOS links to the BIOS routines, the BIOS routines also prove to be inadequate 
when using those skeletal functions that MS-DOS does provide. 
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If you inspect the BIOS listing in the IBM Technical Reference Manual on pages 
A-22 - A-25, you’ll find that DSR and CTS must be asserted before transmitting a 
character over the communications channel. While the protocol of waiting for 
these signals to be asserted is technically correct, most systems give you an option 
as whether or not the protocol is desired. This type of protocol is often referred to 
as electrical pacing. It is used to pace the communications line, so that if the DCE is 
not prepared to receive characters from the DTE, the transmissions from the DTE 
will be temporarily suspended. Many systems and lower-priced modems do not 
use these signal lines. Therefore, you must prepare a null modem cable, as pre¬ 
viously described, to make the software believe that these signals are active. 

The BIOS routines do not afford the necessary control over the communications 
channel when operated in an interrupt driven mode. The use of interrupts is 
desirable when communicating with another computer. If interrupts were not 
used, the communications port would have to be periodically polled to insure the 
proper reception of received characters. If the communications channel is not 
polled frequently enough, characters may be lost. When the UART receiver hold¬ 
ing register is full (a character has been received) and another character arrives 
before the program retrieves the first character, the UART generates an overrun 
error. Therefore, when using higher communication rates (1200 to 9600 baud), 
your program must be ready to accept a character as soon as it is available at the 
receiver port. 

This severely limits the amount of processing that can take place, since most of the 
8088’s time is spent polling the communications channel. The use of interrupts 
allows the 8088 to perform whatever processing chores are required without 
spending valuable time polling the channel. It also allows higher baud rates to be 
used in communications without sacrificing processing time dedicated to other 
tasks. 

In order to carry out communications via the asynchronous communications 
adapter in the most efficient manner, you must directly program and access the 
registers of the National Semiconductor INS 8250 UART and the Intel 8259 pro¬ 
grammable interrupt controller. 

BIOS routines can be used to initialize many of the communications parameters. 
However, the registers of the chips must be accessed to perform other functions. 
I’ll first discuss the registers of interest to us and then explain what MS-DOS and 
BIOS routines are acceptable when programming for data communications. 


Where to Start 


Refer to Listing 10-1 as I discuss COMM.ASM’s operation. The listing contains bit 
map assignments to the 8250 UART registers I’ll describe in a moment. 
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Physical 
Port Assignments 


If you look at Listing 10-1, the port assignments for the National Semiconductor 
8250 UART found on the asynchronous communications adapter hoard are listed 
at the beginning of the source file. 


The Baud Rate 

Divisor Registers .. 

Type: Output 

Ports: 03F8H (LSB of divisor word) 
03F9H (MSB of divisor word) 


To access the baud rate divisor registers, bit 7 of the line control register must be set 
to a binary 1. The least significant byte can be accessed at port 03F8H, and the most 
significant byte at port address 03F9H. These registers specify a divisor that 
determines the baud rate for the communications channel. The 1.8432-megahertz 
clock signal is divided by the value specified in the divisor registers to generate the 
necessary baud rate timing. 

Notice that simply dividing the 1.8432-megahertz clock signal by the divisor 
specified does not return the baud rate. The value returned by performing this 
division is 16 times the baud rate. The 8250 must sample the Receive Data input 
(RD) at a rate of 16 times the baud rate to be sure the data transitions (mark to space, 
etc.) are valid. On seeing a mark to space transition, the UART samples the RD line 
toward the middle of the bit cell, or on the 8th of the 16 clocks, to verify that the 
transition was caused by a valid start bit and not by noise being generated on the 
line. If the RD input is still in a spacing condition, the initial mark to space 
transition is then assumed to be generated from a valid start bit. Therefore, you can 
calculate the baud rate divisor by 1,843,200/(BAUD RATE x 16). For those who do 
not have a calculator handy, use the table shown in Listing 10-1. 

You can program the channel for 9600-baud operation in the following manner: 


MOV 

AL,BOH 

•Set bit 7 of 

line control register. 

MOV 

DX,03FBH 

;Port address 

for line control register. 

OUT 

D 

X 

J> 

r 

;Bit 7 now set 

- 

DEC 

DX 

;Point to port 

03F9H, MSB of divisor. 


continued 
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DEC 

DX 

% 

MOV 

AL,0OH 

;MSB of divisor 

OUT 

DX, AL 

5 Set up MS of divisor. 

DEC 

DX 

$Point DX to port 03F8H 

MOV 

AL,0CH 

5 Get LSB of divisor 

;(1.843E Mhz / (9600 « 16)) 

OUT 

DX, AL 

;Set LSB of divisor. 


Once the baud rate divisor is set, the remainder of the communication parameters 
can be specified. 


The Line 
Control Register 

I Type: Output 


Port: 03FBH 


The line control register must be programmed to the communications parameters 
desired. You have control over the word length, number of stop bits, and whether 
to enable odd or even parity or disable parity altogether. 

Bit 6 can be used to transmit a break on the communications channel. A break is a 
continuous space. A line break may signal the other system to stop transmitting, 
because there is an abnormality at the other end of the line. 

When bit 7 in the line control register is reset, the transmitter and receiver holding 
registers at port 03F8H and the interrupt enable register at port 03F9H can be 
accessed. When bit 7 is set to a binary 1, those two port addresses provide access to 
the baud rate divisor registers. The least significant byte of the baud rate divisor is 
accessed via port 03F8H, and the most significant byte can be accessed via port 
03F9H. 

For example, you would output a value of OFH to port 03FBH to program the chip 
for 8-bit word lengths with odd parity and 2 stop bits. Bit 7 is now reset and allows 
the receiver and transmitter holding register to be accessed rather than the baud 
rate divisor registers. 
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Transmitter and Receiver 


Type: Input (Receiver) 


Type: Output (Transmitter) 


Port: 03F8H 


The transmitter holding register (THR) and Receiver Holding Register (RHR) are 
both assigned to port 03F8H. Data is read from the RHR by using the statements: 

MOV DX,e3F6H «6et the port address of the RHR. 

IN AL,DX ;Get data from port. 

Similarly, data is transmitted by using the statements: 

MOV DX,03F8H ;Oet the port address of the THR 

OUT DX,HL ;Transmit the character. 

Each of these registers is capable of generating an interrupt. The transmitter can 
interrupt the 8088 when the holding register or shift register is empty, and the 
receiver can interrupt the 8088 when a character has been received (RHR full), or 
when a receive error has occurred. 

The Modem 
Control Register 

I Type: Output 


Port: 03FCH 


The modem control register controls the setting of the modem control signals DTR 
and RTS. If bO = 1, then DTR is active (space), and, if hi is set to a binary 1, RTS is set 
to the on state (space). Two other signals generated by the 8250 are controlled 
throiigh this register, OUTl* and OUT2*. The OUT2* signal is active when b3 in 
the modem control register is set to a binary 1. Bit 3 must be set if interrupts are 
enabled from the ACA board. OUT2 * enables the gating of the interrupt signal to 
the system bus of the PC. You can see this pictorially in the schematic on page D-88 
of the IBM Technical Reference Manual (publication 6025005). 
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When bit 4 is set, the 8250 is put into a special diagnostic mode. The receiver input 
and the transmitter output are connected in the 8250. Any characters transmitted 
are therefore received. The physical receiver connection to the communications 
line from the chip is disconnected, and the transmitter output is set to a marking 
condition. The diagnostic mode is useful to test the receive and transmit functions 
of the 8250 to test interrupt service routines. 

The remaining bits, b5, b6, and hi, in the modem control register must always be 
set to zero. 

Interrupt 

Enable Register . . .—— 

Type: Output 


Port: 03F9H 


The interrupt enable register dictates what conditions (if any) will generate an 
interrupt to the 8088. Bit 3 of the modem control register must be set to a binary 1 if 
any of the interrupt types are enabled. Bits 4-7 of this register must always be set to 
zero. If bit 3 is set, the 8250 generates an interrupt when there is a change in the 
modem status register. The modem status register will be discussed in a moment. 

If bit 2 is set, then the 8250 generates an interrupt when a break is detected on the 
receiver input or when a character is received in error. When bit 1 is set, the 8250 
generates an interrupt when the THR is empty and ready for the next character to 
be transmitted. When bit 0 is set, it enables interrupts to be generated whenever a 
character has been received (RHR full). 

The interrupt service routine determines which of the possible interrupts 
occurred. This can be easily accomplished by reading the interrupt identification 
port 03FAH. 

The Interrupt 

Identification Register . ■ - 

I Type: Input 


Port: 03FAH 


To check whether an interrupt has occurred, test bO of the interrupt ID port. If the 
bit is set, then there is an interrupt pending. If the bit is reset, no interrupts are 
pending. Bits 1 and 2 code the interrupt type and priority of the interrupts as 
follows: 
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b2 

b1 

Type 

Priority Levei 

0 

0 

Change in Modem Status 

3 (lowest) 

0 

1 

THR Empty 

2 

1 

0 

RHR Full 

1 

1 

1 

Received error, or break 
detected. 

0 (highest) 


You must read this port after each interrupt has been serviced and prior to 
returning from the current service routine to see if any other interrupts occurred 
during the service routine. Failure to do so will inhibit interrupts which occurred 
during a service routine from being recognized. 

The interrupt ID bits are reset when the appropriate action has been taken. For 
example, if a THR empty interrupt has occurred, the interrupt is reset when a 
character is output to the THR. To reset the receiver full interrupt, input the 
character from the RHR. Similarly, reading the line status clears level 0 interrupts, 
and reading the modem status register clears level 3 interrupts. 


The Line 
Status Register 


The line status register provides information about the communications channel. 
The register can be read to determine if a character has been received or to 
determine what type of error occurred, if any. 

The port maps the status of the communications channel as follows: 

b0 as 1 as Receive data ready 
bl * 1 = Overrun error 
bS a 1 s Parity error 
b3 * 1 * Framing error 
b 4 » 1 SB Break interrupt 
bS SB 1 as thR empty 

b6 SB 1 as Transmit shift register empty 
b7 is always zero. 

You must check bit 5 before attempting to transmit a character. If b5 = 0, then do 
not output the character to the THR. Similarly, bO should be checked prior to 
attempting to input a character from the RHR. 
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Overrun Error 

If you have ever seen a baseball game when one base runner overruns the lead 
runner (also known as bush league base running), you can easily visualize what 
happens when a character overrun occurs in the receiver. The UART receives a 
character, and, before the program has a chance to retrieve the character, another 
character arrives at the receiver. The first character has been overrun by the 
second. This type of error normally does not occur in a properly designed program 
that uses interrupts. 

Parity Error ■" 

A parity error occurs when parity error checking has been enabled, and the parity 
of the received character does not match the parity type in use. If the UART detects 
odd parity when even parity is enabled (or even when odd is enabled), a parity 
error is generated. 

Framiug Error ■ 

This type of error is caused by an improper character framing. Each character 
transmitted asynchronously is framed by start and stop bits. The stop bit returns 
the communications channel to a marking condition. A framing error is most likely 
to occur when the line does not return to a marking state after the character or 
parity bit has been transmitted. This condition can signal the start of a received 
break. 

Modem 

Status Register . . 

Type: Input 


Port: 03FEH _ 

The modem status register returns the status of the signals that communicate with 
the RS-232C interface. The signals are used as modem controls. The port is bit 
mapped as follows: 

b 0 a 1 s Change in clear to send (CT 8 ) 

bl a 1 a Change in data set ready <DSR) 

b 8 a 1 s Change in ring indicator (RI) (trailing edge from 1 to 0) 

b3 s 1 B Change in carrier detect (CD) 

b4 * 1 * Clear to send (CTS) 
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b5 =* 

1 

B Data 

set ready 

(DSR) 

b6 » 

1 

= Ring 

indicator 

(RI) 

b7 = 

1 

* Carrier detect 

(CD) 


The 8259 
Interrupt Controller 



Interrupt Mask 
Register (IMR) - 

Type: Output 
1 Port: 21H 


In a communications program that uses interrupts, it is necessary that the 8259 
interrupt controller he set up to recognize the interrupts generated hy the ACA 
hoard. The 8259 interrupt controller can generate up to 8 vectored interrupts to 
the 8088. The 8259 accepts Interrupt ReQuests (IRQs) from the peripherals 
attached to the system, determines which has the highest priority, and interrupts 
the 8088 CPU. A vector address is placed on the bus that the 8088 uses to obtain the 
segment address and offset address to the service routine for that interrupt type. 
The 8259 is initialized to provide the 8088 with interrupt types 08H to OFH, as 
illustrated in Table 10-14. 


Interrupt Type 

Function 

Priority 

08H 

Timer (Channel Zero) 

0 

09H 

Keyboard 

1 

OAH 

Color Adapter Board 

2 

OBH 

N/A 

3 

OCH 

Serial Adapter Board 

4 

ODH 

N/A 

5 

OEH 

Disk Drives 

6 

OFH 

Printer 

7 


Table 10-7 8259 Interrupt Types 
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The communications board is assigned to the interrupt vector address OCH in the 
interrupt vector table in low memory (see Chapter 3, Figure 3-8). The interrupt 
type is determined by the values BIOS uses during system initialization. You should 
not alter these vector types by reprogramming the 8259. 

The two registers of interest in the 8259 are the command register and the 
interrupt mask register. The command register accepts either initialization com¬ 
mand words or operational command words. Since BIOS initializes the 8259, I 
won’t get into the many initialization options available. The information is ade¬ 
quately covered in the Intel Microsystem Components Handbook, Volume I 
(# 230843-001, pages 2-120 to 2-137), should you want to delve into the initializa¬ 
tion mode further. 

The only operational command word of interest to us here is the End of Interrupt 
(EOI) command 20H. Actually, it is referred to in the Intel literature as a specific 
EOI command. The EOI command must be output to the command register of the 
8259 after an interrupt has been serviced. It is the last action taken by the service 
routine prior to executing the IRET instruction. IRET returns control to the 
program or task that was executed prior to the interrupt. 

The interrupt mask register allows you to mask, or prevent, any of the interrupt 
types from being generated (disabled). If the bit corresponding to the interrupt 
type (IRQ0,etc.) is set in the IMR, the interrupt type is disabled. To enable an 
interrupt type, the corresponding bit in the IMR must be reset. This register can be 
read (via the IN AL,21H) to determine the currently enabled interrupt types. 



Although the functions MS-DOS provides for communications prove to be inadequate 
except for the simplest of programming chores, I will briefly discuss each of them. The 
functions can be found in the MACFLE.MAC listing discussed in Chapter 6. 


Receive Function 

Function: 03H(INT21H) ~ 

Macro: @ WAITAUX (See Chapter 6) 


This function can be used to retrieve a character from the RHR of the 8250 UART. 
You should first test bit 0 in the line status register before executing this function. If 
bO is set, then a character has been received and is available in the receiver holding 
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register. If you do not check bO in the line status register, this function will wait 
until a character is ready or until a BIOS-defined time limit has elapsed (time-out). 

This call is relatively useless in a multitasking environment where you cannot wait 
for anything. Use it if you must, and only when interrupts or other processing 
chores will not suffer. 

To invoke the function, move 03H into AH and execute INT 21H. The character 
will be returned in AL. If a Control-Z is received, the function will execute an INT 
23H which is a Control-C interrupt. 

Transmitting 

Characters- 


Function: 04H(INT21H) 


Macro: @ AUXOUT (See Chapter 6) 


This function transmits the character in the DL register to the communications 
channel. It waits until CTS and DSR are asserted by the other computing device or 
the DCE (modem). If the signals are not active, the function waits a specified 
amount of time, then executes a time-out and return without having transmitted 
the character. You can study the BIOS routine in the IBM Technical Reference 
Manual to understand how this function operates. 



INT14H- 

BIOS offers more than the two functions MS-DOS does. However, BIOS still waits 
for the electrical signals CTS and DSR to be asserted at the RS-232C interface 
connector. BIOS adds two other functions, one of which can be used to set the 
communication parameters of baud rate, word length, parity, and the number of 
stop bits. The other function can be used to read the line control status and modem 
status registers. The DX register must contain the serial port desired, zero for the 
primary port and 1 for the secondary port (the second ACA board, if installed). 
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Transmitting a Character 

via BIOS---- 

BIOS Function: OlH (INT14H) ” 

[DX] = Serial port 

nu mber _ 

Macro: @RS_SEND 

This function sends the character in the AL register to the communications chan¬ 
nel. The function waits for the DSR and CTS signals to be asserted prior to sending 
the character. If bit 7 is set on return from the function, an error occurred and is 
defined as follows: 

PH « Error code; 

b0 a 1 » RHR full (data ready) 

bl a 1 SB Overrun error 

b2 * 1 » Parity error 

b3 « 1 * Framing error 

b4 B 1 s Break detect 

bS B 1 a THR empty 

b6 » 1 B Transmitter shift register empty 

Again, if your application can afford to wait for the signals DSR and CTS to be 
asserted by the DCE, use this function. If your application does not care about nor 
require these signals to be present, do not use this function. I’ll show you how to 
transmit a character directly to the port in the programming example presented 
later in this chapter. 

Receiving a Character 

via BIOS - 

Function: 02H(INTl4H) 

[D X] = Serial port number __ 

Macro: @RS_INPUT (See Chapter 6) 

This function waits for a character to arrive at the serial port. It waits for DSR to be 
asserted before attempting to input the character from the receiver holding register 
oftheUART. 
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If the signal is not asserted, the routine returns after a specified amount of time 
with bit 7 in AH set to indicate the time-out. In fact, any nonzero value in AH 
indicates an error has occurred. The error is mapped in an identical manner as for 
the transmit function (OlH) previously discussed. If AH is zero on returning from 
this function, the character is in AL. 


Setting the Communications 
Parameters 

Function: 00H(INT14H) 

[DX] = Serial port number _ 

Macro: @RS232_INIT (See Chapter 6) __ 

This function sets the baud rate, word length, parity, and number of stop bits 
required for communications. The bit pattern must be set as shown in Listing 10-1. 
Once you have decided on the character protocol, move the value into AL, zero 
into AH, set DX to the serial port number, and execute INT14H. 


Reading the Line 

and Modem Status " 

Function: 03H(INTl4H) 

[D X] = Serial port number _ 

Macro: @RS_STATUS (See Chapter 6) _ 

This function can be used to obtain the line status and the modem status. The line 
status is returned in AH and the modem status in AL. The exact bit mapping and 
significance is illustrated in Listing 10-1. 



In the program COMM .ASM, I have tried to tie all the programming tips and tricks 
discussed thus far into a real-life application, a communications program. With an 


IIIUIIIII 
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assembled version of the programs in Listings 10-1 and 10-2 and a modem, you will 
be able to communicate with other computers over the telephone. 

The program supports a feature known as data capture, whereby all characters 
received and transmitted are spooled to disk. You can print this file later when you 
are off-line, saving time and money. If you must obtain an immediate hard copy of 
the communications in progress, you can also route all received and transmitted 
data to the printer. 

Additionally, the program allows you to transmit an ASCII file via the communica¬ 
tions port. This is commonly referred to as downloading a file to another com¬ 
puter. If you own one of the many lap-top computers, such as the Radio Shack 
Model 100 or 200 or the NEC 8201A, you can use this program to transfer ASCII files 
from the lap-top computer to the IBM. 

The program also illustrates many new concepts, such as circular and double 
buffering and the installation and support of RS-232 interrupts. 

The Main Program Loop 


Although the program cannot be considered to be a true multitasking system where 
multiple jobs or tasks are carried out simultaneously, it gives the appearance that 
the keyboard disk, communications, printer, and display functions are executing 
concurrently. 

The main loop of the program does nothing except call each functional module 
within COMM.ASM. The program label MAIN_LOOP to EXIT is the loop that is 
continually executed. Within the loop, the program checks to see if there is a 
nonzero value in RAM location EXIT_FLAG. This RAM location contains a nonzero 
value when the keyboard routine detects an ALT - Z key combination entered from 
the keyboard. This control is used to terminate the program. 

Four basic routines are called from the main program loop: RECEIVE, KEYBOARD, 
TX_RS232, and PRINTER_OUT_l. I’ll discuss each in detail in a moment. 

The main program first calls a procedure to initialize the RS-232 and set other 
functioning parameters of the program. The called procedure, INIT, prompts you 
for the various parameters and initializes the communications port. This pro¬ 
cedure also installs the RS-232 interrupt vector. 


Procedure: 

INIT- 

This procedure prompts you for the baud rate desired, the parity type if any, the 
number of stop bits, and the word length to be used in communications. Each 
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prompting session sets or resets the appropriate bit positions in the RAM location 
CONFIGURATION. This byte in RAM specifies the character protocol to be used. 

Once the parameters have been specified, the program asks you if you want 
transmitted characters to be echoed to the display. If the communications channel 
is half duplex, answer yes to the echo prompt. If the channel is full duplex (where 
the host computer echoes back all characters received from your terminal), answer 
no to the prompt. Bit 6 in the RAM location SYSTEM_STATUS is set if you answer 
yes to the prompt and reset if local echo is not desired. 

Now find the program label SET_CONFIGURATION in the INIT procedure. The 
macro @RS232_INIT is invoked, and the parameter CONFIGURATION is passed to 
the macro. The macro uses the contents of this RAM location to set the character 
protocol. The macro invokes the BIOS function OOH using BIOS interrupt type 
14H. I could have gone directly to the 8250 ports to initialize the character 
protocol, but this particular BIOS function is easier to use and program than direct 
port addressing would be. 


Installing a New 
Interrupt Service Routine 


Once the 8250 has been initialized with the character protocol, a new interrupt 
vector that points to the program’s RS-232C interrupt service routine is installed. 
The ES and BX registers are saved, and the MS-DOS function 35H is invoked to read 
the current interrupt vector. 

The macro @READ_VECTOR invokes the MS-DOS function 35H. The value OCH is 
passed to the macro. This is the interrupt type for the communications card. When 
the macro is expanded (see the MACFLE.MAC listing in Appendix D), it moves the 
interrupt type into AL and the MS-DOS function number 35H into AL and executes 
the INT 21H instruction. On return, the current interrupt vector for type OCH will 
be in the following registers: 

ES * Segment address of vector- 

BX * Offset pointing to the first byte of the service routine. 


These values should be saved when altering any interrupt vector in low RAM. Prior 
to terminating your program, the original values should be reinstated in the vector 
table. In the program, the values are saved in the data segment at RAM locations 
OLD_VECTOR (segment) and OLD_VECTOR + [2] (offset). 

The contents of DS are saved on the stack and the effective address of the new 
interrupt service routine is moved into the DX register (LEA DX,RS232_INT_1). 
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The code segment where the routine resides is moved into DS: 

MOV flX,MY_CODE 
MOV DS, AX 

The interrupt type is moved into AL, and the MS-DOS function code 25H is moved 
into AH. Then the INT 21H instruction is executed. The program then restores DS 
(POP DS). 

Interrupts are disabled (CLI) until the 8250 UART and the 8259 interrupt controller 
have been initiali2ed. Since you are programming the interrupt control registers of 
the 8250 UART and the 8259 interrupt controller, it is best to disable all interrupts 
until your bit twiddling is completed. 

RTS and DTR are set to true (space) in the modem status register of the UART. Next, 
any pending interrupts are reset by performing a dummy read to the line status 
register. Now it’s time to enable the 8250 interrupts. A value of OlH is moved into 
the AL register. This defines the interrupt mask for the 8250. Since bO is the only bit 
set in the mask, only interrupts received by the 8250 are enabled. Anytime the 
8250 completely receives a character, an interrupt is generated. 

This value is output to the interrupt enable register of the 8250 (port 03F9H). It 
would be nice and easy if this were all there was to enable interrupts from the ACA 
board; however, there is one more chip that must be initialized. The 8259 must be 
able to recognize not just the ACA board interrupts, but it must also recognize any 
other system peripheral interrupts necessary for the program and the operating 
system to function properly. In this example, I enabled interrupts for the disk 
drive, communications board, keyboard, and the 8253 timer. If you disable any of 
these interrupts, the associated device will not be able to generate an interrupt 
request to the 8088, and the system will either hang or return erroneous results. 

Once you have established the interrupt vector and enabled the interrupt types, the 
instruction STI is executed, which enables the 8088 to respond to any of the 
interrupts specified. 


Program Operation 


You may have come to think of program execution as being carried out one 
instruction at a time. While it is true that this view of program execution is 
technically correct, you do have to modify your thinking when working in an 
interrupt driven environment. Since interrupts can occur at any time from a 
number of different sources, care must be taken in defining how the program deals 
with them. 
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When communications over a high speed channel (9600 baud or greater), a First In, 
First Out (FIFO) buffer is used to store the characters as they are received via the 
ACA board. While the ACA receiver interrupt is being serviced, other programming 
tasks are suspended. Therefore, most all of your interrupt service routines should 
be kept as short as possible. Leave any processing of the data to other routines 
which execute during normal program operation, not at interrupt time. 


Interrupt Service Routine 


The different procedures found in COMM.ASM are assigned very specific func¬ 
tions. The interrupt service routine for the RS-232C must detect any errors in the 
receiver, such as framing errors, parity errors, overrun errors, or detecting a break 
condition. The service routine places the ASCII code lAH in the receive buffer if an 
error is detected. If no error is detected, the character is input from the UART RHR 
and placed in the next empty position in the receive buffer. 

Notice in the interrupt handler at the program label GET_CHAR, that the DS and ES 
registers are reintialized to point to the data segment. This is important. BIOS 
routines (such as disk and timer routines) reinitializes DS and ES. The routines save 
the registers’ contents and point them to scratch areas used by MS-DOS and BIOS. 
Should an RS-232 interrupt occur when the registers are pointing to a BIOS or MS- 
DOS data segment, you stand a good chance of wiping out variables used by the 
operating system. Furthermore, data received during an interrupt will never be 
saved in the receiver buffer, as the registers are not pointing to the proper data 
segment. 

The interrupt handler adjusts the input pointer RS_IN_POINT and increments the 
character counter RS_CHARS. The input pointer points to the next open position 
in the receive buffer. Similarly, there is an output pointer associated with the buffer 
that points to the next character to be removed from the buffer for processing. 

The rule here is: Never assume anything during interrupts. Save the registers on 
entry, reinitialize them with the data segment of your choice, and restore the DS 
and ES registers to their former values before executing the IRET instruction. 


More on Data Buffers 


A buffer is a dedicated portion of contiguous memory used to temporarily hold 
data. By buffering the data, the devices that the data are destined for have enough 
time to process the information. There always exists the possibility the devices 
may be too slow to keep up with the rate at which the buffers are filled. With 
proper definition at design time, the dynamics of the system can be anticipated and 
enough time allocated to properly handle data processing. 
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The buffers used in COMM.ASM are first in, first out (FIFO) buffers. Each buffer has 
two pointers and a character counter associated with it. One pointer is used as an 
input pointer, which points to the next available location in the buffer. The other 
pointer is the output pointer. It points to the next active character position in the 
buffer. The counter is used in order to avoid lengthy computations to determine if 
there are characters in the buffer awaiting processing. A routine which must 
process active characters simply has to test the character count of the buffer. If the 
value is zero, there are no active characters awaiting processing, and the next task 
is allowed to execute. 

A task which must put characters into the buffer takes the following action: 

1. Fetch the buffer’s input pointer address. 

2. Store the desired value at the byte pointed to by the buffer’s input address 
pointer. 

3. Increment the pointer by either 1 or 2, depending on whether a byte or a 
word had been stored in the buffer. 

4. Maintain pointer integrity by making sure the pointer continues to point to 
the next available location in the buffer. 

5. Increment the character counter by one, thus indicating a character has been 
added to the buffer and awaits processing. 

To maintain pointer integrity as mentioned in step four, the address pointer usually 
has certain bits reset by the routine manipulating the pointer. For example, if the 
maximum buffer size is 16 bytes, bits 4-15 must always be reset before the routine 
saves the new value of the offset. This insures the buffer will not extend beyond its 
allocated memory depth. To demonstrate further, assume we are using a l6-byte 
buffer and the current offset contains the binary value 0000 0000 0000 1111. The 
buffer offset is pointing to the last physical byte allocated to the buffer. After 
incrementing the offset, its new value will be: 

0000 0000 0001 0000 (binary); 

which, when added to the virtual start address of the buffer, would be pointing one 
byte past the end of the buffer. 

By resetting bit 4 of the offset value, the offset is reset to 0000 0000 0000 0000, or 
the first physical location of the buffer. This keeps the buffer circular. When the 
last physical position of the buffer is occupied, it wraps around and points to the 
first position. Figure 10-14 illustrates the concept of circular buffering further. 

Another important concept is that of double buffering. By providing two or more 
buffers from which to process characters or data, asynchronous tasks are able to be 
synchronized to available resources within the system. Each task is assigned spe¬ 
cific responsibilities as to when and how data are deposited into a particular buffer 
and when and how the data are removed from a buffer. Often the data are routed to 
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Buffer Pointer 




Figure 10*14 

another buffer associated with a logical or physical system resource. The second 
buffer can then be emptied by the task which is associated with that buffer. 

Refer to Figure 10-15. Notice the UART receive buffer receives data in a random and 
asynchronous manner. The arrival of the data is unpredictable as it is received from 
the communications channel, which is asynchronous. COMM.ASM uses interrupt 
to alert the processor when a character is received via the RS-232C interface. At 
interrupt time, the character is put into a buffer associated with the UART’s 
receiver function. Refer now to program Listing 10-1 in Appendix D. In the pro¬ 
cedure RS232_INT the interrupt handler is defined. 

When a character is put into a buffer, the input pointer to the buffer and the buffer’s 
character count are incremented. When a character is taken from the buffer, the 
output pointer is incremented to point to the next character’s position, and the 
character count is decremented by one. A procedure can simply check the char¬ 
acter count to determine if there are any characters awaiting processing in the 
buffer. 

Find the GET_CHAR label in the program. The input pointer to the receiver buffer 
is moved to the SI register. After inputting a character from the RHR, the procedure 
branches to the label POINT_ADJ. The pointer is incremented and logically ANDed 
with the value 07FFH. Since the buffer for the communications channel is 2048 
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Figure 10-15 


bytes in length, this action insures that the pointer will wrap around and point to 
the beginning of the buffer after the last buffer position has been used. 

Nothing more is done with respect to processing the character at this time. The 
interrupt routine terminates and returns control to the task which was executing 
when the interrupt occurred. 


Procedure: RECEIVE 

To demonstrate the concept of double buffering refer to the program listing at the 
label RECEIVE. This is where the characters previously stored in the UART buffer 
are processed. Notice that the routine immediately checks the value of RS_CHARS. 
If the value is zero, there are no characters in the UART buffer, and the routine 
returns to the main program loop. If there are characters waiting in the buffer, the 
offset RS_OUT_POINT is added to the buffer’s start address RS_BUFFER to obtain 
the correct pointer value of the next character to process. 

The RS_IN_POINT and the RS_OUT_POINT pointers do not have to keep pace 
with each other. If for some reason the input pointer gets far enough ahead of the 
output pointer, it is understood that each process has the ability to signal a possible 
overflow condition and request that other routines (or even the communications 
channel) be prevented from sending characters to it until it is emptied. This flow 
control further synchronizes the otherwise asynchronous execution of tasks 
within the system. 
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Once a character is received from the buffer, it is processed. The processing occurs 
at task time. Therefore, it is possible to be buffering additional characters in the 
primary buffer through interrupts while processing or putting a character into 
secondary buffers at task time. The character may be routed to the video display, a 
printer buffer, the capture buffer, or to a disk buffer, if the task associated with the 
secondary buffer is active. If the task is not active, the character is not put into the 
task’s buffer (see Figure 10-16). 



•A' 




Figure 10-16 


Through the use of these secondary buffers, the associated tasks, when called from 
the job list, must handle the processing of the character. The printer job then gets a 
character from its buffer and sends it to the printer when and if the printer is ready. 
The disk spooler uses yet another buffer from which the operating system (MS- 
DOS) writes a 512-byte sector to disk when the buffer becomes full. It is the 
responsibility of the lower level tasks to communicate flow control information to 
the higher level tasks. If secondary buffers are filling up faster than they can be 
emptied, communications are paced to allow the buffer to be emptied without 
losing data. 

All buffer management, whether at primary or secondary levels, is handled in the 
same manner as shown in these examples. 
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Procedure: KEYBOARD . — 

Characters typed from the keyboard are processed by the procedure KEYBOARD. 
The keyboard routine uses the MS-DOS function 06H to return a character from the 
keyboard if one is available. DL is set to OFFH, which informs the function not to 
echo characters typed to the screen. 

The routine checks for the following control characters: DCl, DC2, DC3, and DC4 
(ASCII codes IIH, 12H, 13H, and 14H). These controls perform specific functions in 
the program as illustrated in Figure 10-17. 


Keyboard Control 

Function 

ALT-B 

Download an ASCII file 

ALT-D 

Toggle Disk Spooler On/Off 

ALT-H 

Display the help menu 

ALT-Z 

Exit to DOS 

CTRL-Q 

DC1 (XON) 

CTRL-R 

DC2 (Printer On) 

CTRL-S 

DC3(XOFF) 

CTRL-T 

DC4 (Printer Off) 


Figure 10-17 Control Codes used in COMM.ASM 


The keyboard handler must test to see if the ALT key is being pressed in conjunc¬ 
tion with another key. Any other character is placed in the transmit buffer at the 
program label STUFF_BUFFER. The buffer pointer is incremented and kept circular 
by ANDing the input pointer value with OOFFH. The characters put into the 
transmit buffer by the keyboard routine are removed from the buffer and transmit¬ 
ted by the procedure TX_RS232. 

Procedure: TX_RS232 -- — 

This procedure is called from the main program loop. The first action taken in this 
procedure is to ascertain if any characters have been placed in the transmit buffer 
by the KEYBOARD or DLOAD procedure. If the value of TX__CHARS is zero, there 
are no characters in the buffer and the procedure returns to the main program loop. 
If TX_CHARS contains a nonzero value, then the procedure continues. 

When the receive buffer stands a chance of overflowing, as when more characters 
are being received than are being removed, the program or terminal transmits a 
DC3 (ASCII 13H) to the remote system. It’s the computer’s way of saying stop 
sending for a moment. When the situation alleviates itself and the buffer has been 
adjusted so that the possibility of an overflow has been eliminated or reduced, the 
program sends a DCl control (ASCII IIH) to the remote to resume transmission. 
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This form of flow control, or buffer management, is character oriented as opposed 
to the electrical pacing techniques that BIOS provides when using DSR with DTR 
and CTS with RTS in transmission. 

The program suspends transmissions when the printer buffer is about to overflow, 
when the DC3 control is typed from the keyboard (Control-S), or when the remote 
system sends a DC3 to you. In an ideal situation, the remote terminal would 
recognize the DC3 as soon as it arrives. In reality, the remote system will have 
already sent a number of characters before the DC3 is received. Therefore, be sure 
to allow enough room in the buffer to account for the characters that may still be 
on the way to your terminal after you have sent the DC3 • As a rule of thumb, when a 
buffer fills to about three-quarters of its capacity, send a DC3, and when the buffer 
is about one-quarter full, send a DCl to resume transmissions. 

The transmit procedure also returns to the calling program without having sent a 
character if it finds that the THR of the UART is not empty. You cannot load a 
character into the THR unless the register is empty. 

If there are characters in the TX buffer, no DC 3 has been sent and the transmitter 
holding register of the UART is empty, the next character to be removed from the 
TX buffer is fetched and transmitted to the communications channel. If the char¬ 
acter is a DC3 or a DCl, bit 5 of RAM location SYSTEM_STATUS is set or reset to 
reflect the control was encountered. 

SYSTEM_STATUS is tested to see if bit 6 is set or reset. If the bit is set, then the user 
elected during the initialization portion of the program to echo all characters 
transmitted to the display. If the bit is reset, then the procedure will not echo the 
characters transmitted to the display. 

If the character transmitted is carriage return (ODH), then the RAM location 
SYSTEM_STATUS is checked to see if bit 6 is set. This bit is set during initialization 
if you have elected to execute a carriage return/linefeed combination when a 
carriage return is encountered; otherwise, the procedure executes the carriage 
return only. 


Spooling 


Procedure: 

TURN_DISK_ON_OFF- 

If you type an ALT-D from the keyboard, disk spooling is enabled. When ALT-D is 
typed once the feature has been enabled, the spool file is closed and spooling to the 
disk file will cease. ALT-D acts as a toggle to enable or disable the spooling feature. 
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When invoked, you are prompted for a standard MS-DOS filename, including a 
drive specification, pathname, filename, and an extension, if desired. 

The procedure uses MS-DOS 2.0 disk access mechanisms to create the disk file and 
write to disk. The MS-DOS function 3CH is used to create the file. The function 
returns a l6-bit file handle, which must be used during subsequent file access. The 
file handle is stored in the RAM location FILE_HANDLE in the data segment. The 
DTA is set to point to DISK_BUFFER in the data segment. If an error occurs during 
the creation of the file, an error message is displayed and the procedure is termi¬ 
nated. 

Procedure: DISK.IN- 

The procedure DISK_IN stores the character in DL in the DTA of an open file. After 
each character is transferred to the buffer, the character counter DISK_IN is 
incremented. When the count equals 512 bytes, a sector is written to disk. If there is 
a disk error, the file is closed and an error message is displayed. The only control 
characters that are stored to disk are carriage returns, linefeeds, and the backspace 
character. All other control characters are ignored by this procedure. 


Procedure: 

PRINTER_IN_1- 

This procedure is responsible for placing the character in DL into the printer buffer 
when the printer spooling option is enabled. To enable this option, press Control-R 
(DC2). To disable printer spooling, press Control-T (DC4). If the buffer fills to 200 
characters, the routine automatically sends a DC3 over the communications chan¬ 
nel. The PRINTER_OUT_l procedure is responsible for sending a DCl to the 
remote system when the buffer contains fewer than 100 characters. 


Procedure: 

PRINTER_OUT_l- 

This procedure transmits a character stored in the printer buffer to the printer if 
one is available. If you toggle the printer on, be sure you have one attached to the 
system and that it is on-line. Nowhere in the routine is a check made to see if a 
printer is really part of the system. The program will hang up once the printer 
buffer exceeds 200 characters if a printer is not attached to the system. 

The procedure checks to see if a DC3 printer condition exists and, if so, checks the 
depth of the printer buffer. If there are fewer than 100 characters in the buffer, a 
DCl is transmitted over the communications line, and the DC3 condition is reset. 
Normal transmission and reception can then resume. 
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Downloading Files (ALT-B) 


When you press ALT-B, the procedure DLOAD is activated (see Listing 10-2 in 
Appendix D). This file reads a disk file one sector at a time and places the characters 
read into the transmit buffer. The procedure checks the keyboard during execution 
for a key closure. If a key has been pressed, the procedure aborts and returns to the 
terminal mode. 

When the download function is first activated, you are prompted for the drive, 
pathname, filename, and extension of the file to be downloaded. If there is an error 
in opening the file, the procedure displays an error message and returns to the 
terminal mode. 

The specified file must be an ASCII text file. It cannot be a binary file. Since the 
program uses XON and XOFF flow control, you cannot transmit a file containing 
either of these control characters. 


Help Menu 


Should you forget what the limited control key sequences are which control the 
program, press ALT-H and a help menu will be displayed. The keyboard procedure 
in Listing 10-1 contains the routine HELP which clears the screen and displays the 
help menu. 


Exiting the Program 


To end the communications program press ALT-Z. This sets the exit flag, which is 
checked in the main program loop (MAIN_LOOP). When the program finds the exit 
flag set, the original interrupt vector for communications is restored, and you are 
returned to MS-DOS. 



You should study the listing of each procedure in detail in Listings 10-1 and 10-2. 
Experiment and alter the routines. Add new procedures that will increase the 
utility of the program. 













318 80881IBM PC Assembly Language Programming 


Try adding these features to the program: 

1. Character filters to create your own code translation tables for keyboard and 
received characters. 

2. A procedure to transmit a binary file. 

The list could go on. I suggest you take a look at some of the commercial programs 
available and incorporate similar features into your own custom telecommunica¬ 
tions program. Assembly Language programming can be rewarding, money saving 
(you won’t have to buy as many programs), and educational. I hope you found the 
programming examples in this book to be all of these and more. 

There were many more programming examples and programming applications I 
wanted to cover; yet time and space would not permit. The more advanced 
subjects will have to wait for the follow-up book: 80881IBM PC Assembly Lan¬ 
guage Programming—Book II. 



1 • A_is a device that performs parallel to serial conversion of data. 

2. Hardware interrupts are prioritized by the_PIC. 

3. Full-duplex allows simultaneous_communica¬ 

tions. 

4. Simplex is a simple-minded form of conversation. True or False. 

5. Asynchronous communication does/does not require a timing element to be 
transmitted for synchronization. 

6. Using PSK modulation, what is the modulation rate of a 1200 bit per second 
communication channel? 

7. The UART found on the serial I/O board is a National Semiconductor 
_(part number). 

8. The line control register of the UART controls the RS-232C signals of the 
communications line. True or False. 
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9. Define the 8-bit binary pattern which must be written to the 8259 IMR 
register to enable only timer, printer, and disk interrupts. 

10. The MS-DOS function_can be used to transmit a character via 

the serial communications adapter. 

11. The function listed in question 10 will_until_and 

_are asserted prior to transmitting a character. 





_ ASCII, BAUDOT, EBCDIC 

ASCII is a 7-bit code defining character and control codes from OOH to 7FH. 

Baudot is a 5-bit code that defines figures and letters from OOH to IFH. By use of 
figures shift or letters shift, the number of characters represented is extended to 60 
characters. 

EBCDIC is an 8-bit character code that defines characters and control codes from 
OOH to FFH. It is most often used by IBM mainframes in communications. 


BAUDOT 


Binary 

ASCII 

Figures/Letters 

EBCDIC 

Hexidecimal 

0000 

0000 

NULL 

Blank 

Blank 

NULL 

OOH 

0000 

0001 

SOH 

3 

E 

SOH 

OlH 

0000 

0010 

STX 

Linefeed 

Linefeed 

STX 

02H 

0000 

0011 

ETX 

- 

A 

ETX 

03H 

0000 

0100 

EOT 

Space 

Space 

PF 

04H 

0000 

0101 

ENQ 

, 

S 

HT 

OSH 

0000 

0110 

ACK 

8 

I 

LC 

06H 

0000 

0111 

BEL 

7 

U 

DEL 

07H 

0000 

1000 

BS 

CR 

CR 


OSH 

321 
























Binary 

ASCII 

BAUDOT 

Figures/Letters 

EBCDIC 

Hexidecimal 

0000 

1001 

HT 

ENQ D 


09H 

0000 

1010 

LF 

4 R 

SMM 

OAH 

0000 

1011 

VT 

BEL J 

VT 

OBH 

0000 

1100 

FF 

, N 

FF 

OCH 

0000 

1101 

CR 

$ F 

CR 

ODH 

0000 

1110 

so 

: C 

SO 

OEH 

0000 

nil 

SI 

( K 

SI 

OFH 

0001 

0000 

DLE 

5 T 

DLE 

lOH 

0001 

0001 

DCl 

" Z 

DCl 

IIH 

0001 

0010 

DC2 

) L 

DC2 

12H 

0001 

0011 

DC3 

2 W 

TM 

13H 

0001 

0100 

DC4 

# H 

RES 

14H 

0001 

0101 

NAK 

6 Y 

NL 

15H 

0001 

0110 

SYN 

0 P 

BS 

16H 

0001 

0111 

ETB 

1 Q 

IL 

17H 

0001 

1000 

CAN 

9 0 

CAN 

18H 

0001 

1001 

EM 

? B 

EM 

19H 

0001 

1010 

SUB 

& G 

CC 

lAH 

0001 

1011 

ESC 

[Figures Shift] 

CUl 

IBH 

0001 

1100 

FS 

" M 

IFS 

ICH 

0001 

1101 

GS 

/ X 

IGS 

IDH 

0001 

1110 

RS 

; V 

IRS 

lEH 

0001 

nil 

US 

[Letters Shift] 

lUS 

IFH 

0010 

0000 

SPACE 


DS 

20H 

0010 

0001 

1 


SOS 

21H 

0010 

0010 

// 


FS 

22H 

0010 

0011 

# 



23H 

0010 

0100 

$ 


BYP 

24H 

0010 

0101 

% 


LF 

25H 

0010 

0110 

& 


ETB 

26H 

0010 

0111 



ESC 

27H 

0010 

1000 

( . 



28H 

0010 

1001 

) 



29H 

0010 

1010 

* 


SM 

2AH 

0010 

1011 

+ 


CU2 

2BH 

0010 

1100 

, 



2CH 

0010 

1101 

- 


enq 

2DH 

0010 

1110 



ACK 

2EH 

0010 

nil 

/ 


BEL 

2FH 

0011 

0000 

0 



30H 

0011 

0001 

1 



31H 

0011 

0010 

2 


SYN 

32H 

0011 

0011 

3 



33H 

0011 

0100 

4 


PN 

34H 

0011 

0101 

5 


RS 

35H 

0011 

0110 

6 


UC 

36H 

0011 

0111 

7 


EOT 

37H 

0011 

1000 

8 



38H 

0011 

1001 

9 



39H 

0011 

1010 




3AH 
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Binary 


ASCII 

BAUDOT 

Figures/Letters 

EBCDIC 

Hexidecimal 

0011 

1011 



CU3 

3BH 

0011 

1100 

< 


DC4 

3CH 

0011 

1101 

= 


NAK 

3DH 

0011 

1110 

> 



3EH 

0011 

1111 

? 


SUB 

3FH 

0100 

0000 



SPACE 

40H 

0100 

0001 

A 



41H 

0100 

0010 

B 



42H 

0100 

0011 

c 



43H 

0100 

0100 

D 



44H 

0100 

0101 

E 



45H 

0100 

0110 

F 



46H 

0100 

0111 

G 



47H 

0100 

1000 

H 



48H 

0100 

1001 

I 



49H 

0100 

1010 

J 



4AH 

0100 

1011 

K 



4BH 

0100 

1100 

L 


< 

4CH 

0100 

1101 

M 


( 

4DH 

0100 

1110 

N 


-f 

4EH 

0100 

nil 

0 


1 

4FH 

0101 

0000 

p 


1 

50H 

0101 

0001 

Q 



51H 

0101 

0010 

R 



52H 

0101 

0011 

s 



53H 

0101 

0100 

T 



54H 

0101 

0101 

u 



55H 

0101 

0110 

V 



56H 

0101 

0111 

w 



57H 

0101 

1000 

X 



58H 

0101 

1001 

Y 



59H 

0101 

1010 

z 


j 

5AH 

0101 

1011 

1 


$ 

5BH 

0101 

1100 

\ 


* 

5CH 

0101 

1101 

1 


) 

SDH 

0101 

1110 



; 

5EH 

0101 

1111 




5FH 

0110 

0000 

\ 


- 

60H 

0110 

0001 

a 


/ 

61H 

0110 

0010 

b 



62H 

0110 

0011 

c 



63H 

0110 

0100 

d 



64H 

0110 

0101 

e 



65H 

0110 

0110 

f 



66H 

0110 

0111 

g 



67H 

0110 

1000 

h 



68H 

0110 

1001 

i 



69H 

0110 

1010 

j 



6AH 

0110 

1011 

k 


, 

6BH 

0110 

1100 

1 


% 

6CH 
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Binary 

ASCII 

BAUDOT 

Figures/Letters 

EBCDIC 

Hexidecimal 

0110 

1101 

m 



6DH 

0110 

1110 

n 


> 

6EH 

0110 

nil 

0 


p 

6FH 

0111 

0000 

p 



70H 

0111 

0001 

q 



71H 

0111 

0010 

r 



72H 

0111 

0011 

s 



73H 

0111 

0100 

t 



74H 

0111 

0101 

u 



75H 

0111 

0110 

V 



76H 

0111 

0111 

w 



77H 

0111 

1000 

X 



78H 

0111 

1001 

y 



79H 

0111 

1010 

z 



7AH 

0111 

1011 

{ 


# 

7BH 

0111 

1100 

1 


@ 

7CH 

0111 

1101 

) 



7DH 

0111 

1110 



= 

7EH 

0111 

nil 

RUBOUT 


// 

7FH 



(DEL) 




1000 

0000 




80H 

1000 

0001 



a 

81H 

1000 

0010 



b 

82H 

1000 

0011 



c 

83H 

1000 

0100 



d 

84H 

1000 

0101 



e 

85H 

1000 

0110 



f 

86H 

1000 

0111 



g 

87H 

1000 

1000 



h 

88H 

1000 

1001 



i 

89H 


1001 

0001 

j 

91H 

1001 

0010 

k 

92H 

1001 

0011 

1 

93H 

1001 

0100 

m 

94H 

1001 

0101 

n 

95H 

1001 

0110 

o 

96H 

1001 

0111 

P 

97H 

1001 

1000 

q 

98H 

1001 

1001 

r 

99H 


1010 

0010 

s 

A2H 

1010 

0011 

t 

A3H 

1010 

0100 

u 

A4H 

1010 

0101 

V 

ASH 

1010 

0110 

w 

A6H 

1010 

0111 

X 

A7H 

1010 

1000 

y 

A8H 
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1010 

1001 

1100 

0000 

1100 

0001 

1100 

0010 

1100 

0011 

1100 

0100 

1100 

0101 

1100 

0110 

1100 

0111 

1100 

1000 

1100 

1001 

1101 

0000 

1101 

0001 

1101 

0010 

1101 

0011 

1101 

0100 

1101 

0101 

1101 

0110 

1101 

0111 

1101 

1000 



1110 

0010 

1110 

0011 

1110 

0100 

1110 

0101 

1110 

0110 

1110 

0111 

1110 

1000 

1110 

1001 

nil 

0000 

nil 

0001 

nil 

0010 

nil 

0011 

nil 

0100 

nil 

0101 

nil 

0110 

nil 

0111 

nil 

1000 

nil 

1001 


{ 

COH 

A 

CIH 

B 

C2H 

c 

C3H 

D 

C4H 

E 

G5H 

F 

C6H 

G 

C7H 

H 

C8H 

I 

C9H 

} 

DOH 

J 

DIH 

K 

D2H 

L 

D3H 

M 

D4H 

N 

D5H 

o 

D6H 

p 

D7H 

Q 

D8H 

R 

D9H 

S 

E2H 

T 

E3H 

U 

E4H 

V 

E5H 

W 

E6H 

X 

E7H 

Y 

E8H 

Z 

E9H 

0 

FOH 

1 

FIH 

2 

F2H 

3 

F3H 

4 

F4H 

5 

F5H 

6 

F6H 

7 

F7H 

8 

F8H 

9 

F9H 








The following is the complete 8088/86 instruction set as published in the Intel 
iAPX 88 Book (pages 2-51 through 2-68), Intel order number 210200-002. The 
instruction set is reprinted with the permission of Intel Corporation. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-20. Effective Address Calculation 
Time 


EA COMPONENTS 

CLOCKS* 

Displacement Onlv 

6 

Base or Index Only 

(BX,BP,SI,DI) 

5 

Displacement 





9 

Base or Index 

(BX,BP,SI,DI) 


Base 

BP + DI, BX + SI 

7 

Index 

BP + $I.BX + DI 

8 

Displacement 

BP + DI + DISP 

11 

+ 

BX + SI + DISP 

Base 



+ 

BP + SI + DISP 

12 

Index 

BX + DI + DISP 


*Add 2 clocks for segment override 


that the BIU can obtain the bus on demand, i.e., 
that no other processors are competing for the 
bus.) 


With typical instruction mixes, the time actually 
required to execute a sequence of instructions will 
typically be within 5-10<?^o of the sum of the 
individual timings given in table 2-21. Cases can 
be constructed, however, in which execution time 
may be much higher than the sum of the figures 
provided in the table. The execution time for a 
given sequence of instructions, however, is always 
repeatable, assuming comparable external condi¬ 
tions (interrupts, coprocessor activity, etc.). If the 
execution time for a given series of instructions 
must be determined exactly, the instructions 
should be run on an execution vehicle such as the 
SDK-86 or the iSBC 86/12^^ board. 


Table 2-21. Instruction Set Reference Data 


AAA 

AAA (no operands) 

ASCII adjust for addition 

Flags ODITSZAPC 
u U U X U X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

4 

— 

1 

AAA 


AAD 

AAD (no operands) 

ASCII adjust for division 

Fi«n« ODITSZAPC 
^ ® U X X U X U 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

60 

— 

2 

AAD 


AAM 

AAM (no operands) 

ASCII adjust for multiply 

Plan. ODITSZAPC 
^ ® U X X U X U 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

83 

— 

1 

AAM 


AAS 

AAS (no operands) 

ASCII adjust for subtraction 

Flags ODITSZAPC 
u U U X U X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

4 

— 

1 

AAS 


*For the 8086, add four clocks for each 16-blt word transfer with an odd address. For the 8088, add four clocks for each 16-blt word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


ADC 

ADC destination,source 

Add with carry 

Flans OD'TSZAPC 
® X X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

ADC AX, SI 

register, memory 


9 + EA 

1 

2-4 

ADC DX, BETA [SI] 

memory, register 


16+EA 

2 

2-4 

ADC ALPHA [BX] [SI], Dl 

register. Immediate 


4 

— 

3-4 

ADC BX, 256 

memory. Immediate 


17+EA 

2 

3-6 

ADC GAMMA, 30H 

accumulator, immediate 


4 

— 

2-3 

ADC AL, 5 


ADD 

ADD destination,source 

Addition 

ODITSZAPC 
riags X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

ADD CX, DX 

register, memory 


9 + EA 

1 

2-4 

ADD Dl, [BX].ALPHA 

memory, register 


16+EA 

2 

2-4 

ADD TEMP, CL 

register, immediate 


4 

•— 

3-4 

ADD CL, 2 

memory, immediate 


17+EA 

2 

3-6 

ADD ALPHA, 2 

accumulator, immediate 


4 

— 

2-3 

ADD AX, 200 


AND 

AND destination,source 

Logical and 

Pi«n« ODITSZAPC 
^ 0 X X U X 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

AND AL.BL 

register, memory 


9 + EA 

1 

2-4 

AND CX,FLAG_WORD 

memory, register 


16+EA 

2 

2-4 

AND ASCII [DI],AL 

register, immediate 


4 

— 

3-4 

AND CX,0F0H 

memory, immediate 


17+EA 

2 

3-6 

AND BETA, 01H 

accumulator, immediate 


4 

— 

2-3 

AND AX,01010000B 


CALL 

CALL target 

Call a procedure 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Examples 

near-proc 


19 

1 

3 

CALL NEAR_PROC 

far-proc 


28 

2 

5 

CALL FAR_PROC 

memptr16 


21 + EA 

2 

2-4 

CALL PROC_TABLE [SI] 

regptr16 


16 

1 

2 

CALL AX 

memptr 32 


37+EA 

4 

2-4 

CALL [BX].TASK [SI] 


CBW 

CBW (no operands) 

Convert byte to word 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

CBW 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8036 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


CLC 

CLC (no operands) 

Clear carry flag 

ODITSZAPC 
Flags g 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

CLC 


CLD 

CLD (no operands) 

Clear direction flag 

Pi.n« ODITSZAPC 
Flags Q 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

CLD 


CLI 

CLI (no operands) 

Clear Interrupt flag 

,,, ODITSZAPC 
Flags g 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

CLI 


CMC 

CMC (no operands) 

Complement carry flag 

Cl.-. ODITSZAPC 
Flags ^ 

Operands 

CIOCKS 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

CMC 


CMP 

CMP destination,source 

Compare destination to source 

ODITSZAPC 

X X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

CMP BX,CX 

register, memory 


9 + EA 

1 

2-4 

CMP DH, ALPHA 

memory, register 


9 + EA 

1 

2-4 

CMP [BP+ 2], SI 

register, immediate 


4 

— 

3-4 

CMP BL,02H 

memory. Immediate 


10 + EA 

1 

3-6 

CMP [BXJ.RADAR [Dl], 3420H 

accumulator, immediate 


4 

— 

2-3 

CMP AL,00010000B 


CMPS 

CMPS dest-string,source-string 

Compare string 

ODITSZAPC 

X X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

dest-string, source-string 


22 

2 

1 

CMPS BUFF1, BUFF2 

(repeat) dest-string, source-string 

9+ 22/rep 

2/rep 

1 

REPECMPS ID, KEY 


*For the 8086, add four clocks for each 16-blt word transfer with an odd address. For the 8088, add four clocks for each 16-blt word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


CWD 


Operands 


(no operands) 


DAA 


CWD (no operands) 

Convert word to doubleword 


Clocks Transfers* * Bytes 


ODITSZAPC 


Coding Example 


Operands 


(no operands) 


DAS 


DAA (no operands) 
Decimal adjust for addition 


Clocks Transfers* Bytes 


ODITSZAPC 
® X X X X X X 


Coding Example 


Operands 


(no operands) 


DEC 


DAS (no operands) 

Decimal adjust for subtraction 


Clocks Transfers* Bytes 


ODITSZAPC 
* U X X X X X 


Coding Example 


Operands 


reg16 

reg8 

memory 


DEC destination 
Decrement by 1 


Clocks 


2 

3 

15 + EA 


Transfers* Bytes 


ODITSZAPC 
® X X X X X 


Coding Example 



DEC AX 
DEC AL 

DEC ARRAY [SI] 



Operands 


immediate, memory 
Immediate, register 


DIV source 
Division, unsigned 


ODITSZAPC 
U U U UU U 


Clocks 

Transfers* 

Bytes 

Coding E 

80-90 

— 

2 

DIV CL 

144-162 

— 

2 

DIV BX 

(86-96) 

+ EA 

1 

2-4 

DIV ALPHA 

(150-168) 
+ EA 

1 

2-4 

DIV TABLE [SI] 



ESC external-opcode,source ODITSZAPC 

Escape 


Clocks Transfers* Bytes Coding Example 


2-4 ESC 6,ARRAY [SI] 

2 ESC 20,AL 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


HLT 

HLT (no operands) 

Halt 

Flags OD'TSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

HLT 


IDIV 

IDIV source 

Integer division 

ODITSZAPC 

U U U U U U 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

reg8 


101-112 

— 

2 

IDIV BL 

regie 


165-184 

— 

2 

IDIV CX 

mem8 


(107-118) 

1 

2-4 

IDIV DIVISOR_BYTE [Si] 



+ EA 




mem16 


(171-190) 

1 

2-4 

IDIV [BX].DIVISOR_WORD 



+ EA 





IMUL 

IMUL source 

Integer multiplication 

Pi,n« ODITSZAPC 
^ X U U U U X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

reg8 


80-98 

— 

2 

IMUL CL 

reg16 


128-154 

— 

2 

IMUL BX 

mem8 


(86-104) 

1 

2-4 

IMUL RATE_BYTE 



+ EA 




mem16 


(134-160) 

1 

2-4 

IMUL RATE_WORD [BP] [Dl] 



+ EA 





IN 

IN accumulator,port 

Input byte or word 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

accumulator, immed8 


10 

1 

2 

IN AL,0FFEAH 

accumulator, DX 


8 

1 

1 

IN AX,DX 


INC 

INC destination 

Increment by 1 

Pl»n« ODITSZAPC 

X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

reg16 


2 

— 

1 

INC CX 

reg8 


3 

— 

2 

INC BL 

memory 


15+EA 

2 

2-4 

INC ALPHA [Dl] [BX] 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


INT 

INT interrupt-type 

Interrupt 

Pi-n« ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

immed8(type = 3) 


52 

5 

1 

INT 3 

ImmedS (type 3) 


51 

5 

2 

INT 67 


INTRt 

INTR (external maskable interrupt) 
Interrupt If INTR and IF=1 

Fi»«« ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

61 

7 

N/A 

N/A 


INTO 

INTO (no operands) 

Interrupt If overflow 

Fi»o« ODITSZAPC 

0 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

53 or 4 

5 

1 

INTO 


IRET 

IRET (no operands) 

Interrupt Return 

Flags ODITSZAPC 
9 RRRRRRRRR 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

24 

3 

1 

IRET 


JA/JNBE 

JA/JNBE short-label 

Jump if above/Jump if not below nor equal 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JA ABOVE 


JAE/JNB 

JAE/JNB short-label 

Jump if above or equal/Jump if not below 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JAE ABOVE_EQUAL 


JB/JNAE 

JB/JNAE short-label 

Jump if below/Jump if not above nor equal 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JB BELOW 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
tINTR is not an instruction; it is included in table 2-21 only for timing information. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


JBE/JNA 

JBE/JNA short-label 

Jump if below or equal/Jump if not above 

Flags 0 D 1 T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNA NOT_ABOVE 


JC 

JC short-label 

Jump If carry 

Flags 0 D I T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JC CARRY_SET 


JCXZ 

JCXZ short-label 

Jump If CX Is zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

18or6 

— 

2 

JCXZ COUNT_DONE 


JE/JZ 

JE/JZ short-label 

Jump If equal/Jump If zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JZ ZERO 


JG/JNLE 

JG/JNLE short-label 

Jump if greater/Jump if not less nor equal 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16 or 4 

— 

2 

JG GREATER 


JGE/JNL 

JGE/JNL short-label 

Jump if greater or equal/Jump if not less 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JGE GREATER_EQUAL 


JL/JNGE 

JL/JNGE short-label 

Jump if less/Jump if not greater nor equal 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16 or 4 

— 

2 

JL LESS 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


JLE/JNG 

JLE/JNG short-label 

Jump If less or equal/Jump if not greater 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNG NOT_GREATER 


JMP 

JMP target 

Jump 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 


15 

— 

2 

JMP SHORT 

near-label 


15 

— 

3 

JMP WITHIN_SEGMENT 

far-label 


15 

— 

5 

JMP FAR_LABEL 

memptr16 


18 + EA 

1 

2-4 

JMP [BXJ.TARGET 

regptr16 


11 

— 

2 

JMP OX 

memptr32 


24-l-EA 

2 

2-4 

JMP OTHER.SEG [SI] 


JNC 

JNC short-label 

Jump If not carry 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNC NOT_CARRY 


JNE/JNZ 

JNE/JNZ short-label 

Jump If not equal/Jump if not zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNE NOT_EQUAL 


JNO 

JNO short-label 

Jump If not overflow 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNO NO_OVERFLOW 


JNP/JPO 

JNP/JPO short-label 

Jump if not parity/Jump if parity odd 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JPO ODD__PARITY 


JNS 

JNS short-label 

Jump if not sign 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JNS POSITIVE 


•For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-blt word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


JO 

JO short-label 

Jump If overflow 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

shorMabel 

16or4 

— 

2 

JO SIGNED_OVRFLW 


JP/JPE 

JP/JPE short-label 

Jump If parity/Jump If parity even 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JPE EVEN_PARITY 


JS 

JS short-label 

Jump if sign 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

16or4 

— 

2 

JS NEGATIVE 


LAHF 

LAHF (no operands) 

Load AH from flags 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

4 

— 

1 

LAHF 


LDS 

LDS destination,source 

Load pointer using DS 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers 

Bytes 

Coding Exampie 

reg16, mem32 

16 + EA 

2 

El 

LDS SI.DATA.SEG [Dl] 


LEA 

LEA destination,source 

Load effective address 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Exampie 

reg16, mem16 

2 + EA 

— 

El 

LEA BX, [BP] [Dl] 


LES 

LES destination,source 

Load pointer using ES 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

reg16, mem32 

16-l-EA 

2 

El 

LES Dl, [BX].TEXT_BUFF 


•For the 8086, add four clocks (or each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


LOCK 

LOCK (no operands) 

Lock bus 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

LOCK XCHG FLAG.AL 


LODS 

LODS source-string 

Load string 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

source-string 


12 

1 

1 

LODS CUSTOMER_NAME 

(repeat) source-string 


9 + 13/rep 

1/rep 

1 

REP LODS NAME 


LOOP 

LOOP short-label 

Loop 

,, ODITSZAPC 
Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

17/5 

— 

2 

LOOP AGAIN 


LOOPE/LOOPZ 

LOOPE/LOOPZ short-label 

Loop if equai/Loop If zero 

(DDITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

18or6 

— 

2 

LOOPE AGAIN 


LOOPNE/LOOPNZ 

LOOPNE/LOOPNZ short-label 

Loop If not equal/Loop If not zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

short-label 

19 or 5 

— 

2 

LOOPNE AGAIN 


NMit 

NMI (external nonmaskable interrupt) 
Interrupts NMI = 1 

Fi««« 0 s 1 T S Z A P C 

0 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

50* 

5 

N/A 

N/A 


•For the 8086, add four clocks for each 16-blt word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
tNMI is not an instruction; it is included in table 2-21 only for timing information. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


MOV 

MOV destination,source 

Move 

Flags 0 D 1 T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

memory, accumulator 


10 

1 

3 

MOV ARRAY (SI], AL 

accumulator, memory 


10 

1 

3 

MOV AX,TEMP_RESULT 

register, register 


2 

— 

2 

MOV AX.CX 

register, memory 


8+EA 

1 

2-4 

MOV BP,STACK_TOP 

memory, register 


9 + EA 

1 

2-4 

MOV COUNT [DI],CX 

register, immediate 


4 

-- 

2-3 

MOV CL, 2 

memory, immediate 


IO-fEA 

1 

3-6 

MOV MASK[BX][SI],2CH 

seg-reg, reg16 


2 

— 

2 

MOV ES, CX 

seg-reg, mem16 


8+EA 

1 

2-4 

MOV DS, SEGMENT_BASE 

reg16, seg-reg 


2 

— 

2 

MOV BP,SS 

memory, seg-reg 


9 + EA 

1 

2-4 

MOV [BX].SEG_SAVE,CS 


MOVS 

MOVS dest-string,source-string 

Move string 

Flags 0 D 1 T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

dest-string, source-string 


18 

2 

1 

MOVS LINEEDIT_DATA 

(repeat) dest-string, source-string 

9-1-17/rep 

2/rep 

1 

REP MOVS SCREEN, BUFFER 


MOVSB/MOVSW 

MOVSB/MOVSW (no operands) 

Move string (byte/word) 

Flags 0 D 1 T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 


18 

2 

1 

MOVSB 

(repeat) (no operands) 


9-1-17/rep 

2/rep 

1 

REP MOVSW 


MUL 

MUL source 

Multiplication, unsigned 

Flags OD'TSZAPC 
X U U U U X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

regS 


70-77 

— 

2 

MUL BL 

reg16 


118-133 

— 

2 

MUL CX 

mem8 


(76-83) 

1 

2-4 

MUL MONTH [SI] 



-fEA 




mem16 


(124-139) 

1 

2-4 

MUL BAUD_RATE 



-fEA 





*For the 8086, add four clocks for each 16-blt word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


NEC 

NEG destination 

Negate 

Flags ODITSZAPC 
• ^ X X X X 1 * 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register 


3 

— 

2 

NEG AL 

memory 


16+EA 

2 

2-4 

NEG MULTIPLIER 


*0 if destination = 0 


NOP 

NOP (no operands) 

No Operation 

Flags 0 D I T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

3 

— 

1 

NOP 


NOT 

NOT destination 

Logical not 

Flags 0 D I T S Z A P C 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register 


3 

— 

2 

NOT AX 

memory 


16 + EA 

2 

2-4 

NOT CHARACTER 


OR 

OR destination,source 

Logical inclusive or 

Fi,nc ODITSZAPC 

0 X X U X 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

OR AL, BL 

register, memory 


9 + EA 

1 

2-4 

OR DX, PORT_ID [Dl] 

memory, register 


16 + EA 

2 

2-4 

OR FLAG_BYTE,CL 

accumulator. Immediate 


4 

— 

2-3 

OR AL,01101100B 

register. Immediate 


4 

— 

3-4 

OR CX,01H 

memory, immediate 


17 + EA 

2 

3-6 

OR [BX].CMD_WORD,0CFH 


OUT 

OUT port,accumulator 

Output byte or word 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

immedS, accumulator 


10 

1 

2 

OUT 44, AX 

DX, accumulator 


8 

1 

1 

OUT DX, AL 


POP 

POP destination 

Pop word off stack 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register 


8 

1 

■■ 

POP DX 

seg-reg (CS illegal) 


8 

1 

BDI 

POP DS 

memory 


17+EA 

2 

mm 

POP PARAMETER 


•For the 8086, add four clocks for each 16-blt word transfer with an odd address. For the 8088, add four clocks for each 16-blt word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


POPF 

POPF (no operands) 

Pop flags off stack 

Flags ODITSZAPC 
RRRRRRRRR 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

8 

1 

1 

POPF 


PUSH 

PUSH source 

Push word onto stack 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register 


11 

1 

■■ 

PUSH SI 

seg-reg (CS legal) 


10 

1 


PUSH ES 

memory 


16 + EA 

CM 

Bi 

PUSH RETURN_CODE [SI] 


PUSHF 

PUSHF (no operands) 

Push flags onto stack 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

10 

1 

1 

PUSHF 


RCL 

RCL destination,count 

Rotate left through carry 

Pi»nc ODITSZAPC 
Flags X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, 1 


2 

— 

2 

RCL OX, 1 

register, CL 


8 + 4/bit 

— 

2 

RCL AL, CL 

memory, 1 


15 + EA 

2 

2-4 

RCL ALPHA, 1 

memory, CL 


20 + EA + 

2 

2-4 

RCL [BP].PARM,CL 



4/blt 





RCR 

RCR designation,count 

Rotate right through carry 

ODITSZAPC 
Flags X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, 1 


2 

— 

2 

RCR BX,1 

register, CL 


8 + 4/blt 

— 

2 

RCR BL,CL 

memory, 1 


15 + EA 

2 

2-4 

RCR [BXJ.STATUS, 1 

memory, CL 


20 + EA + 

2 

2-4 

RCR ARRAY [Dl], CL 



4/bit 





REP 

REP (no operands) 

Repeat string operation 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

REP MOVS DEBT, SRCE 


‘For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


REPE/REPZ 

REPE/REPZ (no operands) 

Repeat string operation whiie equal/whiie zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

REPE CM PS DATA, KEY 


REPNE/REPNZ 

REPNE/REPNZ (no operands) 

Repeat string operation whiie not equai/not zero 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

REPNE SCAS INPUT_LINE 


RET 

RET optional-pop-value 

Return from procedure 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(intra-segment, no pop) 


8 

1 

1 

RET 

(intra-segment, pop) 


12 

1 

3 

RET 4 

(inter-segment, no pop) 


18 

2 

1 

RET 

(inter-segment, pop) 


17 

2 

3 

RET 2 


ROL 

ROL destination,count 

Rotate left 

ODITSZAPC 
Flags X 

Operands 

Clocks 

Transfers 

Bytes 

Coding Examples 

register, 1 


2 

— 

2 

ROL BX, 1 

register, CL 


8 + 4/bit 

— 

2 

ROL Dl, CL 

memory, 1 


15 + EA 

2 

2-4 

ROL FLAG_BYTE [Dl],1 

memory, CL 


20 + EA + 

2 

2-4 

ROL ALPHA , CL 


4/bit 





ROR 

ROR destination,count 

Rotate right 

„ ODITSZAPC 
Flags X 

Operand 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, 1 


2 

— 

2 

ROR AL, 1 

register, CL 


8 + 4/blt 

— 

2 

ROR BX,CL 

memory, 1 


15+EA 

2 

2-4 

ROR PORT_STATUS, 1 

memory, CL 


20 + EA + 

2 

2-4 

ROR CMD_WORD, CL 


4/bit 





SAHF 

SAHF (no operands) 

Store AH into flags 

ODITSZAPC 

R R R R R 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

4 

— 

1 

SAHF 


•For the 8086, add four clocks for each 18-blt word transfer with an odd address. For the 8088, add four clocks for each 16-bll word transfer. 


Mnemonics © Intel, 1978 


2-64 


ox ox 










































































8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


SAL/SHL 

SAL/SHL destination,count 

Shift arithmetic left/Shift iogical ieft 

Flea. ODITSZAPC 
Flaoa 

Operands 


Clocks 

Transfers* 

Bytes 

Coding Examples 

registers 


2 

— 

2 

SAL AL,1 

register, CL 


8+4/bit 

— 

2 

SHL DI,CL 

memory,1 


15+EA 

2 

2-4 

SHL [BXJ.OVERDRAW, 1 

memory, CL 


20 + EA + 
4/bit 

2 

2-4 

SAL STORE_COUNT, CL 


SAR 

SAR destination,source 

Shift arithmetic right 

Finn. ODITSZAPC 
X X X U X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, 1 


2 

— 

2 

SAR DX,1 

register, CL 


8 + 4/bit 

— 

2 

SAR DI,CL 

memory, 1 


15+EA 

2 

2-4 

SAR N_BLOCKS, 1 

memory, CL 


20+EA + 

2 

2-4 

SAR N_BLOCKS, CL 



4/bit 





SBB 

SBB destination,source 

Subtract with borrow 

Fi.a« ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 


SBB BX,CX 

register, memory 


9 + EA 

1 


SBB Di, [BX].PAYMENT 

memory, register 


16 + EA 

2 


SBB BALANCE, AX 

accumuiator, immediate 


4 

— 


SBB AX, 2 

register, immediate 


4 

— 

3-4 

SBB CL,1 

memory, immediate 


17+EA 

2 

3-6 

SBB COUNT [SI], 10 


SCAS 

SCAS dest-string 

Scan string 

P, ODITSZAPC 

X X X X X X 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

dest-string 


15 

1 

1 

SCAS INPUT_LINE 

(repeat) dest-string 


9+15/rep 

1/rep 

1 

REPNE SCAS BUFFER 


SEGMENTt 

SEGMENT override prefix 

Override to specified segment 

Flag. ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

MOV SS-.PARAMETER, AX 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 


tASM-88 incorporates the segment override prefix into the operand specification and not as a separate instruction. SEGMENT is included in table 
2-21 only for timing information. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


SHR 

SHR destination,count 

Shift logical right 


ODITSZAPC 
Flags X 

Operands 


Clocks 

Transfers* 

Bytes 

Coding Example 

register, 1 


2 

— 

2 

SHR SI, 1 

register, CL 


8 + 4/blt 

— 

2 

SHR SI, CL 

memory, 1 


15 + EA 

2 

2-4 

SHR ID_BYTE [SI] [BX], 1 

memory, CL 


20 + EA-l- 
4/bit 

2 

2-4 

SHR INPUT_WORD, CL 


SINGLE STEPt 

SINGLE STEP (Trap flag Interrupt) 

Interrupt If TF = 1 

ODITSZAPC 
Flags Q Q 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Exampie 

(no operands) 

50 

5 

N/A 

N/A 


STC 

STC (no operands) 

Set carry flag 

ODITSZAPC 
Flags .| 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Exampie 

(no operands) 

2 

— 

1 

STC 


STD 

STD (no operands) 

Set direction flag 

ODITSZAPC 
Flags .| 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

(no operands) 

2 

— 

1 

STD 


STI 

STI (no operands) 

Set interrupt enable flag 

ODITSZAPC 
Flags ^ 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Exampie 

(no operands) 

2 

— 

1 

STI 


STOS 

STOS dest-string 

Store byte or word string 

ODITSZAPC 

Flags 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Exampie 

dest-string 
(repeat) dest-string 

11 

9 + 10/rep 

1 

1/rep 

1 

1 

STOS PRINT_LINE 

REP STOS DISPLAY 


•For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8068, add four clocks for each 16-bit word transfer. 
fSINGLE STEP is not an Instruction; It Is Included in table 2-21 only for timing Information. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


SUB 

SUB destination,source 

Subtraction 

Fi>«. ODITSZAPC 
® X X X X X X 

Operands 

Clocks 

Transfers* 

Bytea 

Coding Example 

register, register 


3 

— 

2 

SUB CX, BX 

register, memory 


9 + EA 

1 

2-4 

SUB DX, MATH_TOTAL [SI] 

memory, register 


16 + EA 

2 

2-4 

SUB [BP + 2],CL 

accumulator, immediate 


4 

— 

2-3 

SUB AU10 

register. Immediate 


4 

— 

3-4 

SUB SI, 5280 

memory, immediate 


17+EA 

2 

3-6 

SUB [BP].BALANCE, 1000 


TEST 

TEST destination,source 

Test or non-destructive logical and 

Flags ODITSZAPC 
** 0 X X U X 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

TEST SI, Dl 

register, memory 


9 + EA 

1 

2-4 

TEST SI, END_COUNT 

accumulator, immediate 


4 

— 

2-3 

TEST AL, 00100000B 

register, immediate 


5 

— 

3-4 

TEST BX,0CC4H 

memory. Immediate 


11 + EA 

— 

3-6 

TEST RETURN_CODE,01H 


WAIT 

WAIT (no operands) 

Wait while TEST pin not asserted 

Flags ODITSZAPC 

Operands 


Transfers* 

Bytes 

Coding Example 

(no operands) 

3 + 5n 

'■ — 

1 

WAIT 


XCHG 

XCHG destination,source 

Exchange 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

accumulator, reg16 


3 

— 

1 

XCHG AX, BX 

mernory, register 


17+EA 

2 

2-4 

XCHG SEMAPHORE, AX 

register, register 


4 

— 

2 

XCHG AL, BL 


XLAT 

XLAT source-table 

Translate 

Flags ODITSZAPC 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

source-table 

11 

1 

1 

XLAT ASCII_TAB 


*For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-bit word transfer. 
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8086 AND 8088 CENTRAL PROCESSING UNITS 


Table 2-21. Instruction Set Reference Data (Cont’d.) 


XOR 

XOR destination,source 

Logical exclusive or 

ODITSZAPC 

0 X X U X 0 

Operands 

Clocks 

Transfers* 

Bytes 

Coding Example 

register, register 


3 

— 

2 

XOR CX, BX 

register, memory 


9 + EA 

1 

2-4 

XOR CL, MASK_BYTE 

memory, register 


16 + EA 

2 

2-4 

XOR ALPHA [SI], DX 

accumulator, immediate 


4 

— 

2-3 

XOR AL,01000010B 

register, immediate 


4 

— 

3-4 

XOR SI, 6oC2H 

memory, immediate 


17+EA 

2 

3-6 

XOR RETURN_CODE, 0D2H 


•For the 8086, add four clocks for each 16-bit word transfer with an odd address. For the 8088, add four clocks for each 16-blt word transfer. 
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Answers Chapter 1 Review 


1. translate, source 

2. two, one, and zero 

3. two’s 

4. 

A. 10101001 

B. 00001111 


C. 01000001 

D. 10101010 


5 . 


A. 10101010 

B. 00010000 


C. 01000010 

D. 10101011 
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6 . 


A. 

9EH 

C. 

FFH 

B. 

E7H 

D. 

8C0FH 


1 . 


A. 

1111111110100001 

c. 

0111111111111100 

B. 

0010000001111000 

D. 

0000000000000011 


8. So the assembler will not confuse the number with a label. 

9. ASCII, BAUDOT 

10 . 

A. 2 B. 16 C. 10 

11. It contains the letter G, which is not a valid hexadecimal number. 


Answers to Chapter 2 Review 


1. False 

2. False 

3. False, MASM is the IBM Macro Assembler. It is not an editor. 

4. False 

5. Only when absolutely necessary is program code ever entered directly in 
machine language. Machine language entry of programs is tedious and error 
prone. 

6. Symbols, absolute 

7. Modular, understand, maintain, debug 

8. space 

9. comments 

10. Comments help document the program flow, which makes the program 
easier to understand and maintain by others. 
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Answers to Chapter 3 Review 


1. three 

2. CPU, memory, I/O 

3. CPU 

4. two (EU and BIU) 

5. Execution unit (EU), queue 

6 . 16 
7 . 16 

8. 1,048,576 (one megabyte) 

9. B 

10. 65 , 536 -byte segments 

11. segment, offset 

12. Temporary storage of variables and a place to store the instruction pointer 
and code segment register during procedure calls. 

13 . 65.536 (64K) 

14. Maximum 

15 . In maximum mode, the 8088 uses a bus controller (8288) to control the 
address and data bus. In minimum mode, the 8088 is responsible for generat¬ 
ing all the control signals required by the system. Maximum mode allows the 
8088 to be used with co-processors such as the Intel 8087 math processor. 

16. 8 

17. 16 

18. interrupt 

19. A microprocessor requires memory and I/O. A microcomputer not only 
contains the CPU but also the memory and I/O sections of a computer. 

20. 14 

21. AX,BX,CX,DX 

22. 2 

23. 2 

24. 4, CS, DS, ES, SS 

25. False 




350 80881IBM PC Assembly Language Programming 


26. CS and IP 

27. False 

28. Flag, CS, and IP 

29. Disabled, will not 

Or you may have answered: Enabled, will 

30. Direct, immediate, register indirect, base with offset 

31. appendix, effective address 

^Answers to Chapter 4 Review 


1. 

ADD 

COUNTER, 20 

2. 

six 


3. 

CMP 

COUNTER, 20H 


JE 

THERE 


4. Clears the AX register (zeros it). 

5. You cannot specify a constant, as the destination operand in an instruction. 

6. Nothing. AX is stored at the memory location defined by the label FACEH. 
The use of labels such as this is confusing. If a zero preceded the label as in 
OFACEH, the assembler would have generated an error, since OFACEH repre¬ 
sents a hexadecimal number and cannot be used as the destination operand 
of a MOV instruction. 

7. POP 

8. XOR SI,SI ;Zero pointer for first byte 

MOV CX,64 ;Number of bytes to clear 

CLR: MOV COUNTER[SI1,OOH ;Store zero 
INC SI ;Increment the pointer 

LOOP CLR ;Continue until CX = 0 

9. LEA BX,COUNTER 

MOV BX,OFFSET COUNTER 

10. LOOPE, LOOPZ 
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Answers to Chapte r 5 Review 

1. Segment 

2. NEAR or FAR 

3. A-G 
B-F 
C-K 
D-I 
E-j 

Answers to Chapter 6 Review 


4. = (equal) 

5. PAGE 


1. Sequence, instructions 

2. Header (name), body, terminator 

3. terminates 

4. macro’s name 

5. unique 

6. MOV AH,FUNCTION_NUMBER ;MS-DOS function number 

INT 21H ;MS-DOS function request. 

7. A single name can be used to reference several statements required to define 
an MS-DOS function cell. 

Answers to Chapter 8 Review 


1. 

transfer area 

4. 

True 

2. 

buffer, disk 

5. 

False 

3. 

Sequential record 

6. 

six 


Random record 

7. 

program 


Random block 

(See the text for a description of each) 
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Answers to Chapter 9 Review 


1. Basic Input/Output System 

2. False 
3- Four 

4. 128,000 

5. False. The graphics adapter allows for a 320 by 200 medium resolution 
graphics display. 


Answers to Chapter 10 Review 


1. 

UART 

7. 

8250 

2. 

8259 

8. 

False 

3. 

two-way 

9. 

1 1 0 0 0 0 0 1 

4. 

False 

10. 

04H 

5. 

does not 

11. 

wait, DSR and CTS 

6. 

600 baud 
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Listing 2-1 continued 


VID2 

DB 

'80 X 

25 BW Using Color Card*,*$* 

VID3 

DB 

'80 X 

25 BW Using BW Card *,* $ * 

IN_SYS 

DB 

'In System','$' 

MY__DATA ENDS 

t 



;END OF SEGMENT 

t 

MY STACK 

SEGMENT 

PARA 

STACK * STACK * 

DW 

100 DUP( 

?) 


TOP OF STACK 

EQU 

$ 

;WHERE TO START STACK 

MY_STACK 

? 

ENDS 



; DEFINE PROGRAM EQUATES 


DISP_LINE 

EQU 

09H 

;MSDOS FUNCTION CODE 




;TO DISPLAY LINE ->DX 

DISP_CHAR 

EQU 

02H 

7 MSDOS FUNCTION CODE 




;TO DISPLAY CHAR IN DL 

MY CODE SEGMENT 

PARA 

'CODE 

1 

ASSUME 

CS:MY CODE^DS: 

MY DATA,SS:MY STACK,ES:MY DATA 

START PROC 

FAR 


;ENTRY POINT 

INITl: PUSH 

DS 


7 SAVE OLD CODE SEGMENT 




7 PASSED IN DS 

XOR 

AX, AX 


7 SAVE A ZERO OFFSET 

PUSH 

AX 


7 FOR MSDOS RETURN 

INIT2: MOV 

AX,MY DATA 

7 SET UP SEGMENT REGISTERS 

MOV 

DS,AX 



MOV 

ES,AX 



•*★*★*****★* Get the memory size in system. **************** 

GET MEM: 

INT 

12H 

7 GET MEMORY SIZE IN K BYTES 

MOV 

MEM SIZE 

,AX 

7 RETURNED IN AX REGISTER 

GET SYS: 

INT 

IIH 

7 GET SYSTEM CONFIGURATION 

MOV 

HDWR TYPES,AX 

7 RETURNED IN AX 




7 A BIT SET MEANS 




7 THE ITEM IS PRESENT 




7 IN THE SYSTEM 

.********** Clear the screen 

ic1cic1t1tit1cieiticicic*icieicie***icic**it’k**ie** 

CLR SCREEN: 

MOV 

CX,24 

7 SET UP LOOP COUNTER 

CLS: CALL 

CRLF 


7 DO CARRIAGE RETURN LINEFEED 

LOOP 

CLS 


7 FOR CX NUMBER OF TIMES 


;********** Show available memory *************************** 


MEM SHOW: 

LEA DX,MEM 

MESS 7 MEMORY 

MESSAGE 

MOV 

AH,DISP LINE 

7 DISPLAY CODE FOR MSDOS 

INT 

21H 



MOV 

AX,MEM SIZE 

7 GET SIZE 


TEST 

AH,00000010B 

7 TEST B1 OF AH 
7 MEM > 256k 

- IF SET 

JNZ 

M BIG 

t 


TEST 

AH,00000001B 

;TEST B 8 OF AX 

(BO OF AH) 

JNZ 

M256K 

;256K SYSTEM 


TEST 

AL,10000000B 

;TEST B7 OF AX 

IF SET 
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JNZ 

M128K 


TEST 

AL,01100000B 


JNZ 

M96K 

M64K: 

LEA 

DX,MEM 64K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M96K: 

LEA 

DX,MEM 96K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M128K: 

LEA 

DX,MEM 128K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M256K: 


TEST 

AL,11000000B 


JNZ 

M448K 


TEST 

AL,10000000B 


JNZ 

M384k 


TEST 

AL,01100000B 


JNZ 

M352K 


TEST 

AL,01000000B 


JNZ 

M320K 


LEA 

DX,MEM 256K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M448K; 


LEA 

DX,MEM 448K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M320K: 

LEA 

DX,MEM 320K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M352K: 

LEA 

DX,MEM 352K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M384K: 

LEA 

DX,MEM 384K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M BIG: 


TEST 

AL,10000000B 


JNZ 

M640K 


TEST 

AL,01100000B 


JNZ 

M608K 


TEST 

AL,01000000B 


JNZ 

M576K 

M512K: 


LEA 

DX,MEM_512K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M576K: 


LEA 

DX,MEM 576K 


;THEN 128 K SYSTEM 
;TEST B6 AND B5, IF SET 
;THEN 96K SYSTEM 
;DISPLAY MESSAGE FOR 64K 

;DISPLAY MESSAGE FOR 96K 

;DISPLAY 128K MESSAGE 

;THEN 256+ 128 + 64 = 448K 
;THEN 256k + 128k = 384k 
;THEN 256K+96K = 352K 
?THEN 256+64K = 320K 

;DISPLAY MESSAGE FOR 256K 


;Display message 
;Display the message for 

;640k? 

;608k? 

;576k? 

;Assume 512k 

;Display message for memory 
;size. 


CALL 

JMP 


DISP__MESS 

DCONFIG 
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Listing 2-1 continued 


o 

M608K: 

LEA 

DX,MEM 608K 


CALL 

DISP MESS 


JMP 

DCONFIG 

M640K; 

LEA 

DX,MEM 640K 


CALL 

DISP_MESS 


;****** Show the system configuration next. ********* 
; Do video mode first. 


DCONFIG: 

MOV 

INT 

DCl: MOV 

MOV 
ROR 
AND 
DEC 
JZ 
DEC 
JZ 

BWCARD__8025: 

CALL 

JMP 

BWC_8025: 

CALL 

JMP 

BWC_4025: 

CALL 

;********** Now 


LEA 


DX,VIDEO MODE ;GET MESSAGE 


AH,DISP__LINE 

21H 

AX,HDWR_TYPES 
CL,4 
AX, CL 

AL,00000011B 

AL 

BWC_4025 

AL 

BWC__8025 
LEA DX,VID3 

DISP__MESS 
DC 2 

LEA DX,VID2 

DISP__MESS 
DC 2 

LEA DX,VID1 

DISP MESS 


;DISPLAY THE LINE 

GET SYS CONFIG. 

SHIFT BITS 4,5 TO 0,1 

TEST FOR VIDEO MODE 

MASK BITS ONLY 0,1 IMPORTANT 

IF 01, THEN 40 X 25 BLACK/WHITE 

YES THEN GO DISPLAY IT 

IF 02 THEN 80 X 25 B/W 

YES THEN DISPLAY IT 

MUST BE 80 X 25 USING BW CARD 

Display the card type 

GO GET NEXT FUNCTION 

80 X 25 BW USING COLOR CARD 

Display the card type 

GET NEXT VALUE 

40 X 25 BW USING COLOR CARD 

DISPLAY THE CARD TYPE 


test for the number of disk drives int he system. 


DC2: 


MOV 

AX,HDWR TYPES 

;GET STATUS BYTE 

ROR 

AX,1 

;ROTATE BO INTO CARRY 

MOV 

TEMPI,AX 

;STOR VAL IN TEMP 1 

JNC 

DC 3 

;NOT IN SYSTEM, CONTINUE 

LEA 

DX,TOTAL DRIVES 

;MESSAGE FOR DRIVES 

MOV 

AH,DISP LINE 

;MSDOS FUNCTION CODE 

INT 

21H 

;MSDOS CALL 

MOV 

AX,TEMPI 

;RECOVER VALUE 

MOV 

CL,5 

;ROTATE 5 MORE BITS 



;GET BITS 6,7 TO 0,1 

ROR 

AX, CL 

;ROTATE 5 TIMES 

AND 

AL,00000011B 

;MASK BITS 

INC 

AL 

;ADD 1 TO VALUE 

OR 

AL,30H 

;CONVERT TO ASCII 

MOV 

DL,AL 

;SET UP VALUE TO DISPLAY 

MOV 

AH,DISP CHAR 

;MSDOS FUNCTION CODE 

INT 

21H 

;MSDOS CALL 

;********** How 

many RS-232C serial ports in system? 

DC3: CALL 

CRLF 

;NEWLINE 

LEA 

DX,RS232 PORTS 

;OPTION IN SYSTEM? 

MOV 

AH,DISP LINE 

;DISPLAY FUNCTION CODE 

INT 

21H 

;MSDOS CALL 

MOV 

AX,HDWR TYPES 


MOV 

CL,9 

7 ROTATE 9 TIMES 
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ROR 

AX, CL 

;BITS 9,10,11 TO 0,1,2 

AND 

AL,00000111B 

;MASK BITS 

OR 

AL,30H 

;CONVERT TO ASCII 

MOV 

DL,AL 

;SET UP DL WITH CHAR TO DISP 

MOV 

AH,DISP CHAR 

;MSDOS FUNCTION CODE 

INT 

21H 

;MSDOS CALL 

• *********** 
f 

Is the game port 

in the system? 

DC4: CALL 

CRLF 

;NEWLINE 

LEA 

dx,game port 

;GAME PORT IN SYS? 

MOV 

AH,DISP LINE 

;FUNCTION CODE FOR DSPL 

INT 

21H 


MOV 

AX,HDWR TYPES 

;GET CONFIGURATION CODE 

MOV 

CL,13 

;INITIALIZE ROTATE COUNT 

RCR 

AX, CL 

;IN SYSTEM? 

JNC 

DCS 

;IF NOT, CONTINUE. 

CALL 

YES_IN_SYS 

;SAY IT IS ON DISPLAY 

;******* How 

about printers? 

How many? 

DCS: CALL 

CRLF 

;NEWLINE 

LEA 

DX,PRINTER 

;HOW MANY PRINTERS? 

MOV 

AH,DISP LINE 

;FUNCTION CODE FOR DSP 

INT 

21H 


MOV 

AX,HDWR TYPES 

;GET STATUS WORD 

MOV 

CL, 14 

.•INITIALIZE ROTATE COUNT 

ROR 

AX, CL 

;IS IT IN THE SYS? 

AND 

AL,00000011B 

;MASK BITS 

OR 

AL,30H 

;CONVERT TO ASCII 

MOV 

DL,AL 

;SET UP DL FOR DISPLAY 

MOV 

AH,DISP CHAR 

;MSDOS FUNCTION CALL 

INT 

21H 


DONE: RET 

START ENDP 

************************************************************ 

;Procedure to show that the resource is available. 

.*********************************************************** 

r 

YES IN SYS 

PROC NEAR 


LEA 

DX,IN SYS 

;SHOW THAT IS IN THE SYSTEM 

MOV 

AH,DISP__LINE 

;MSD0S function CODE 



;FOR DISPLAYING LINE 

INT 

21H 

;POINTED TO BY DX 
;MSDOS FUNCTION CALL 

RET 


.•RETURN TO CALLER 

YES IN SYS 

ENDP 


.**********★***************************************** 


Carriage return linefeed procedure. Use a similar procedure, 
or this one to generate a carriage return and a line feed 
to move the cursor to the 1st column of the next line 
(also known as a new line function). 
***************************************************** 


PROC 

NEAR 

.•NEWLINE FUNCTION FOR 
;VIDEO 

MOV 

DL.OAH 

;LINEFEED CODE 

MOV 

AH,DISP_CHAR 

;MSDOS FUNCTION CODE 



;TO DISPLAY CHARACTER 

INT 

21H 

;MSD0S call 
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MOV DLfODH ;CARRIAGE RETURN CODE 

MOV AH,DISP_CHAR /DISPLAY THE CHARACTER 

INT 21H 

RET 

CRLF ENDP 


.**** procedure to display memory size - DX MUST BE POINTING 
;**** TO THE BEGINNING OF A MESSAGE STRING ON ENTRY. 

DISP_MESS PROC NEAR 

MOV AH,DISP_LINE ;384K of RAM in system 

INT 21H 

CALL CRLF 

RET 

DISP_MESS ENDP 

• ’k'k'kifklfkltititit’k’kifkititifk'k’kit’k'kifkifltitititit'klt'kititititit'kifkitickititifkitifit 

MY_CODE ENDS 

END INITl 
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Listing 2-2 
CONFIGSY.LST 


The IBM Personal Coapuier HACRO Asseabler 03-03-85 
KXITINE TO ISTURN C(»IFIGURATION SYSTER 


1 



Page 56,132 


2 



TITLE ROUTINE TO RETURN CONFIGURATION OF SYSTEM 


3 



;« Nritten; 06-15-84 


4 



By*. Gary A. Shade 


5 



(c) Gary A. Shade, 1984 


6 

n 



:ti Last Rfivised; 03-03-85 


1 

8 



THIS ROUTINE NILL RETURN THE CURRENT CONFIGURATION 


9 



^ THE SYSTEM AND DISPLAY THE INFORMATION IN THE SCREEN 


10 



; 


11 



U^ IT AS A STAND ALONE ROUTINE, OR AS A PROCEDURE 


12 



•.tt VHICH CAN BE USED TO RETURN STATUS TO A LARGOS PROGRAM. 


13 



;USES BIOS CALLS INT IIH, AND INT 12H TO FETCH EQUIPMENT CONFIG. 

14 



;AND MEMORY SIZE. 


IS 



.!THIS PROCEDURE VILL NOT RECOGNIZE THE PRECENSE (F A 


16 



;¥INCHESTER DISK IN THE SYSTQf. IT ALSO ASSUMES THAT THE 


17 



;S¥ITCHES SET ON THE PC MOTHERBOARD ARE CORRECTLY SET TO REFLECT 

18 



;THE NUMBER OF aOPPY DISK DRIVES IN THE SYSTEM. 


19 





20 



;s^ IBM TECHNICAL REFERENCE MANUAL SYSTEM BIOS, PAGE A-73 


21 



.:FOR A DESCRIPTION OF THE BIT ASSIGNMDiTS USED AS 


22 



.^EQUIPMENT FLAGS (Also illustrated in Chapter 10). 


23 





24 

0000 


MY DATA SEGMENT PARA 'DATA' 


25 

0000 

???? 

NEM„SIZE D¥ ? tSTORAGE FOR MEMCFY SIZE 


26 

0002 

???? 

HDNR.TYPES D¥ ? ;STORAGE FOR HAM)¥ARE TYPES 


27 

0004 

03 [ 

tempi’ D¥ 3 DUP(?) tMISCaLANEOUS STORAGE 


28 


9900 



29 


3 



30 





31 

OOOA 

40 65 60 6F 72 79 

MEM_MESS DB 'Me»ory Available :' 


32 


20 41 76 61 69 6C 



33 


61 62 6C 65 20 20 



34 


20 20 20 20 20 20 



35 


20 20 20 20 20 20 



36 


20 20 3A 20 24 



37 

0020 

49 6E 69 74 69 61 

VIDEO.MODE DB 'Initial Video Mode : ' 
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38 6C 20 56 69 64 65 

39 6P 20 40 6F 64 65 

40 20 20 20 20 20 20 


41 


20 

20 

20 

20 

20 

20 





42 


20 

20 

3A 

20 

24 






43 

0050 

4E 

75 

6D 

62 

65 

72 

TOTAL^DRIVES 

DB 

'Nutber of Disk Drives 

44 


20 

6F 

66 

20 

44 

69 





45 


73 

6B 

20 

44 

72 

69 





46 


76 

65 

73 

20 

20 

20 





47 


20 

20 

20 

20 

20 

20 





48 


20 

20 

3A 

20 

24 






49 

0073 

4E 

75 

60 

62 

65 

72 

RS232_PORTS 

DB 

'Nueber of RS'232 Cards 

50 


20 

6F 

66 

20 

52 

53 





51 


2P 

32 

33 

32 

20 

43 





52 


61 

72 

64 

73 

20 

20 





53 


20 

20 

20 

20 

20 

20 





54 


20 

20 

3A 

20 

24 






55 

0096 

47 

61 

60 

65 

20 

50 

GAME.PORT 

DB 

'Ga»e Port 


56 


6F 

72 

74 

20 

20 

20 





57 


20 

20 

20 

20 

20 

20 





58 


20 

20 

20 

20 

20 

20 





59 


20 

20 

20 

20 

20 

20 





60 


20 

20 

3A 

20 

24 






61 

00B9 

4E 

75 

60 

62 

65 

72 

PRINTER 

DB 

'Nuftber of Printers 

62 


20 

6F 

66 

20 

50 

72 





63 


69 

6E 

74 

65 

72 

73 





64 


20 

20 

20 

20 

20 

20 





65 


20 

20 

20 

20 

20 

20 





66 


20 

20 

3A 

20 

24 






67 












68 

OOOC 

36 

34 

4B 

20 

42 

79 

MEH>4K 

DB 

'64K Bytes^ 


69 


74 

65 

73 

24 







70 

00E6 

39 

36 

4B 

20 

42 

79 

NEH.96K 

DB 

'96K Bytes', 


71 


74 

65 

73 

24 







72 

OOFO 

31 

32 

38 

4B 

20 

42 

MEHJ28K 

DB 

'128K Bytes' 


73 


79 

74 

65 

73 

24 






74 

OOFB 

32 

35 

36 

4B 

20 

42 

HEH.256K 

DB 

'256K Bytes' 


75 


79 

74 

65 

73 

24 






76 

0106 

33 

32 

30 

4B 

20 

42 

MEMJ20K 

DB 

'320K Bytes' 


77 


79 

74 

65 

73 

24 






78 

0111 

33 

35 

32 

4B 

20 

42 

HENJ52K 

DB 

'352K Bytes' 

,'V 

79 


79 

74 

65 

73 

24 






80 

one 

33 

38 

34 

4B 

20 

42 

H01.384K 

DB 

'384K Bytes' 


81 


79 

74 

65 

73 

24 






82 

0127 

34 

34 

38 

4B 

20 

42 

NEH.448K 

DB 

'448K Bytes' 

,'t' 

83 


79 

74 

65 

73 

24 






84 

0132 

35 

31 

32 

4B 

20 

42 

MEH.512K 

DB 

'512K Bytes' 


85 


79 

74 

65 

73 

24 






86 

0130 

35 

37 

36 

4B 

20 

42 

NEN.576K 

DB 

'576K Bytes' 


87 


79 

74 

65 

73 

24 
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88 

0148 

36 30 38 4B 20 42 

MEM_608K 

OB 

'608K BvtesS'i^ 

89 


79 74 65 73 24 





90 

0153 

36 34 30 4B 20 42 

MEM.640K 

DB 

^640K ByiesS^i^ 

91 


79 74 65 73 24 





92 







93 

015E 

34 30 20 58 20 32 

VIDl 

DB 

MO X 25 BV Using Color CardSM' 

94 


35 20 42 57 20 55 





95 


73 69 6E 67 20 43 





96 


6F 6C 6F 72 20 43 





97 


61 72 64 24 





98 

017A 

38 30 20 78 20 32 

VID2 

DB 

'80 X 

25 BW Using Color Card','!' 

99 


35 20 42 57 20 55 





100 


73 69 6E 67 20 43 





101 


6F 6C 6F 72 20 43 





102 


61 72 64 24 





103 

0196 

38 30 20 78 20 32 

VID3 

DB 

'80 X 

25 BV Using BV Card','!' 

104 


35 20 42 57 20 55 





105 


73 69 6E 67 20 42 





106 


57 20 43 61 72 64 





107 


24 





108 

OlAF 

49 6E 20 53 79 73 

IN.SYS 

OB 

'In Syslet','!' 

109 


74 65 6D 24 





110 







111 

01B9 


MY.DATA OIDS 



;END OF ^MENT 

112 



• 




113 



• 




114 

0000 


MY.STACK 

SEGMENT PARA 

STACK 'STACK' 

115 

0000 

64 [ 

D« 

100 DUP(?) 


116 


???? 





117 


3 





118 







119 

00C8 

TOP_OF_STACK 

EQU 

$ 

.:VHERE TO START STACK 

120 

00C8 


HY.STACK 

ENDS 



121 



; 




122 



• 




123 



lEFlNE PROGRAH EQUATES 


124 







125 

= 0009 

DISP.LINE 

EQU 

09H 

JMSDOS FUNCTION CODE 

126 






;TO DISPLAY LINE ->DX 

127 

= 0002 

DISP.CHAR 

EQU 

02H 

;NSDOS FUNCTION CODE 

128 






;TO DISPLAY QIAR IN DL 

129 







130 







131 

0000 


HY.COI^ SEGMENT PARA 

'CODE' 


132 



ASSUME CS:MY.CODE,DS;MY.DATA,SS;MY.STACK,ES;MY.DATA 

133 

0000 


START PROC 

FAR 


;0ITRY POINT 

134 

0000 

IE 

INlTl: PUSH 

OS 


;SAVE OLD CODE SEGMENT 

135 






;PASSED IN DS 

136 

0001 

33 CO 

XOR 

AX,AX 


;SAVE A ZSW OFFSET 

137 

0003 

50 

PUSH 

AX 


;FOR NSOOS RETURN 

138 

0004 

B8 R 

1NIT2I MOV 

AX,MY_DATA 

;SET UP SEGMENT REGISTSiS 

139 

0007 

8E D8 

m 

DS,AX 
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140 

0009 

8EC0 


HOV 

ESyAX 


141 







142 



'ttttttttttt Get the eenory size 

in sysiee. XXXXXXXXXXXXXXXX 

143 







144 

OOOB 

CD 12 

GET.MEH; 


INT 12H 

;GET HENORY SIZE IN K BYTES 

145 

0000 

A3 0000 R 


HOV 

HEH.SIZE.flX 

;RETURNH) IN AX I^ISTER 

146 

0010 

CD 11 

GET.SYS; 


INT IIH 

;GET SYSTEM CONFIGURATION 

147 

0012 

A3 0002 R 


HOV 

HIWR_TYPES,AX 

;RETURNED IN AX 

148 






;A BIT ^T MEANS 

149 






;THE ITEM IS HJESENT 

150 






:IN niE SYSTQI 

151 



•ttmttttt Clear the screen txtxttttnxtttttttxttttttxttttt 

152 







153 

0015 

B9 0018 

CLR SCREEN: 

MOV CX,24 

:SET UP LOOP COUNTQi 

154 

0018 

E8 017D R 

CLS; 

CALL 

CRLF 

:DO CARRIAGE RETURN LINEFEED 

155 

OOIB 

E2 FB 


LOOP 

CLS 

;FOR CX NUMBER Cff TIMES 

156 







157 



IXXXXXXXXXX Show available eeaory XXXXXXXXXXXXXXXXXXXXXXXXXXX 

158 







159 

0010 

8D 16 OOOA R 

NO! SHOV; 

LEA DX,NQI.HESS JHQKIRy MESSAGE 

160 

0021 

B4 09 


MOV 

AH,DISP^LINE 

;DISPLAY CODE FOR MSDOS 

161 

0023 

CD 21 


INT 

21H 


162 

0025 

A1 0000 R 


MOV 

AX,MEM.SIZE 

;GET SIZE 

163 

0028 

F6 C4 02 


TEST 

AHyOOOOOOlOB 

;TEST B1 OF AH - IF SET 

164 






;MEN > 256k 

165 

002B 

75 6D 


JNZ 

M.BIG 

; 

166 

0020 

F6 C4 01 


TEST 

AiiyOOOOOOOlB 

;TEST B8 OF AX (BO OF AH) 

167 

0030 

75 26 


JNZ 

M256K 

;256K SYSTQ! 

168 

0032 

A8 80 


TEST 

ALylOOOOOOOB 

;TEST B7 OF AX IF SET 

169 

0034 

75 18 


JNZ 

M128K 

;THEN 128 K SYSTEM 

170 

0036 

A8 60 


TEST 

ALyOllOOOOOB 

;TEST B6 AND B5, IF SET 

171 

0038 

75 OA 


JNZ 

M96K 

;THEN 96K SYSTEM 

172 

003A 

8D 16 OODC R 

H64K: 

LEA 

DX,MEM_64K 

DISPLAY MESSAGE FOR 64K 

173 

003E 

E8 018A R 


CALL 

DISP^MESS 


174 

0041 

E9 OOCB R 


JMP 

DCONFIG 


175 

0044 

8D 16 00E6 R 

H96K; 

LEA 

DX,MEM_96K 

.!DISPLAY MESSAGE FOR 96K 

176 

0048 

E8 018A R 


CALL 

DISP^MESS 


177 

004B 

ffl 7E 90 


JMP 

DCONFIG 


178 

004E 

8D 16 OOFO R 

H128K; 

LEA 

DXrMEM 128K 

.^DISPLAY 128K MESSAGE 

179 

0052 

E8 018A R 


CALL 

DISP.MESS 


180 

0055 

EB 74 90 


JMP 

DCONFIG 


181 







182 

0058 


H256K: 




183 

0058 

A8 CO 


TEST 

ALyllOOOOOOB 

;THEN 256+ 128 + 64 = 448K 

184 

005A 

75 16 


JNZ 

N448K 


185 

005C 

A8 80 


TEST 

ALylOOOOOOOB 

;THEN 256k + 128k = 384k 

186 

005E 

75 30 


JNZ 

M384k 


187 

0060 

A8 60 


TEST 

ALyOllOOOOOB 

;THEN 256K+96K * 352K 

188 

0062 

75 22 


JNZ 

H352K 


189 

0064 

A8 40 


TEST 

ALyOlOOOOOOB 

;THEN 256+64K - 320K 

190 

0066 

75 14 


JNZ 

M320K 
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191 


192 

0068 

80 16 OOFB R 


LEA 

0X,MEM,256K 

;OISPLAY MESSAGE Fm 256K 

193 

006C 

E8 018A R 


CALL 

OISP_MESS 


194 

006F 

EB 5A 90 


JHP 

OCONFIG 


195 

0072 


H448K: 




196 

0072 

80 16 0127 R 


LEA 

OX,MEM 448K 


197 

0076 

E8 018A R 


CALL 

OISP^MESS 


198 

0079 

EB 50 90 


JMP 

OCONFIG 


199 







200 

007C 

80 16 0106 R 

M320K: 

LEA 

OX,NEM_320K 


201 

0080 

E8 018A R 


CALL 

OISP.MESS 


202 

0083 

EB 46 90 


JMP 

OCONFIG 


203 







204 

0086 

80 16 0111 R 

H352K: 

LEA 

OX,MEM 352K 


205 

008A 

E8 018A R 


CALL 

OISP.MESS 

.'Display Aessaqe 

206 

008D 

3C 90 


JMP 

OCONFIG 


207 







208 

0090 

8016 one R 

N384K: 

LEA 

OX,MEM 384K 

;Display the eessage for 

209 

0094 

E8 018A R 


CALL 

OISP.MESS 


210 

0097 

EB 32 90 


JMP 

OCONFIG 


211 







212 

009A 


H.BIG; 




213 

009A 

A8 80 


TEST 

AL,10000000B 

;640k? 

214 

009C 

75 26 


JNZ 

N640K 


215 

009E 

A8 60 


TEST 

AL,01100000B 

;608k? 

216 

OOAO 

75 18 


JNZ 

M608K 


217 

00A2 

A8 40 


TEST 

AL,01000000B 

;576k? 

218 

00A4 

75 OA 


JNZ 

N576K 


219 






;AssuAe 512k 


00A6 


N512K; 




221 

00A6 

80 16 0132 R 


LEA 

OX,N0IJ12K 

;0i splay Aessaqe for oeAory 

222 






;size. 

223 

OOAA 

E8 018A R 


CALL 

OISP.MESS 


224 

OOAO 

EB 1C 90 


JMP 

OCONFIG 


225 

OOBO 


M576K; 




226 

OOBO 

80 16 0130 R 


LEA 

0X,NEM.576K 


227 

00B4 

E8 018A R 


CALL 

OISP.MESS 


228 

00B7 

EB 12 90 


JMP 

OCC»iFIG 


229 

OOBA 


N608K: 




230 

OOBA 

80 16 0148 R 


LEA 

0X,MOI.608K 


231 

OOBC 

E8 018A R 


CALL 

OISP.MESS 


232 

OOCl 

EB 08 90 


JMP 

OCONFIG 


233 

00C4 


H640K: 




234 

00C4 

80 16 0153 R 


LEA 

OX,MEN.640K 


235 

00C8 

E8 018A R 


CALL 

OISP.MESS 


236 







237 



•tttttt Show the systsA confiquration next, ttttttttt 

238 




Oo video node first. 


239 







240 

OOCB 

80 16 0020 R 

0C0NF16: 

LEA OX,VIOEO.MOOE ;GET MESSAGE 

241 

OOCF 

B4 09 


MOV 

AH,OISP.LINE 

.'DISPLAY THE LINE 

242 

0001 

CO 21 


INT 

21H 
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243 

00D3 

A1 0002 R 

DCi: MOV 

AX,HDWRJYPES 

;GET SYS CONFIG. 

244 

00D6 

B1 04 

MOV 

CL,4 

;SHIFT BITS 4,5 TO 0,1 

245 

00D8 

03 C8 

ROR 

AX,CL 

;TEST FOR VIDEO nm 

246 

OODA 

24 03 

AND 

AL,00000011B 

;MASK BITS ONLY 0,1 IMPORTANT 

247 

OODC 

FE C8 

DEC 

AL 

;IF 01, TH0« 40 X 25 BLACK/NHITE 

248 

OOOE 

74 18 

JZ 

BNCJ025 

;YES THEN GO DISPLAY IT 

249 

OOEO 

FE C8 

DEC 

AL 

;IF 02 THEN 80 X 25 B/N 

250 

00E2 

74 OA 

JZ 

BNCJ025 

;YES THEN DISPLAY IT 

251 

00E4 

80 16 0196 R 

BVCAR0.8025; 

LEA DX,VI03 

:MUST BE 80 X 25 USING BV CARO 

252 

00E8 

E8 018A R 

CALL 

DISP^MESS 

;Oisplay the card type 

253 

OOEB 

EB 12 90 

JMP 

DC2 

.!GO GET NEXT FUNCTION 

254 

OGEE 

80 16 017A R 

BVC 8025: 

LEA DX,VID2 

;80 X 25 BN USING COLOR CARO 

255 

00F2 

E8 018A R 

CALL 

DISP NESS 

:Oisplay the card type 

256 

00F5 

EB 08 90 

JMP 

DC2 

;GET NEXT VALUE 

257 

00F8 

80 16 015E R 

BVC.4025; 

LEA DX,VID1 

;40 X 25 BV USING COLOR CARD 

258 

OOFC 

E8 018A R 

CALL 

DISP.MESS 

^DISPLAY THE CARD TYPE 

259 



•tttitttttt Nov test for the nueber of disk drives ini he systei. 

260 






261 

OOFF 


DC2: 



262 

OOFF 

A1 0002 R 

MOV 

AXvHDVRTYPES 

;GET STATUS BYTE 

263 

0102 

01 C8 

ROR 

AX,1 

;ROTATE BO INTO CARRY 

264 

0104 

A3 0004 R 

MOV 

TEMPI,AX 

:STOR VAL IN T0!P 1 

265 

0107 

73 IB 

JNC 

DC3 

;NOT IN SYSTEM, CONTINUE 

266 

0109 

80 16 0050 R 

LEA 

DX,TOTAL,.DRIVES 

.tHESSAGE FOR DRIVES 

267 

OlOD 

B4 09 

MOV 

AH,DISP.LINE 

:MSDOS FUNCTION CODE 

268 

OlOF 

CD 21 

INT 

21H 

iMSDOS CALL 

269 

GUI 

A1 0004 R 

MOV 

AX,TEMPI 

;R^VER VALUE 

270 

0114 

B1 05 

MOV 

CL,5 

;ROTATE 5 MORE BITS 

271 





;GET BITS 6,7 TO 0,1 

272 

0116 

03 C8 

ROR 

AX,CL 

;ROTATE 5 TIMES 

273 

0118 

24 03 

AND 

AL,0000001IB 

;MASK BITS 

274 

OllA 

FE CO 

INC 

AL 

;AOD 1 TO VALUE 

275 

one 

OC 30 

OR 

AL,30H 

;CONVERT TO ASCII 

276 

OllE 

8A 00 

MOV 

DL,AL 

tSET UP VALUE TO DISPLAY 

277 

0120 

B4 02 

MOV 

AH,DISP_CHAR 

;NSDOS FUNCTION CCM)E 

278 

0122 

CD 21 

INT 

21H 

.tMSDOS CALL 

279 






280 



;mimm hov 

flany RS“232C serial ports in systei? 

281 






282 

0124 

E8 0170 R 

OC3: CALL 

CRLF 

;NEVLINE 

283 

0127 

8D 16 0073 R 

LEA 

DX,RS232_PORTS 

;OPTION IN SYSTEM? 

284 

012B 

B4 09 

NOV 

AH,DISP.LINE 

;DISPLAY FUNCTION CODE 

285 

012D 

CO 21 

INT 

21H 

;MSDOS CALL 

286 

012F 

A1 0002 R 

MOV 

AX,HD«R_TYPES 


287 

0132 

B1 09 

MOV 

CL,9 

;ROTATE 9 TIMES 

288 

0134 

03 C8 

ROR 

AX,CL 

;BITS 9,10,11 TO 0,1,2 

289 

0136 

24 07 

AND 

AL,00000illB 

;MASK BITS 

290 

0138 

OC 30 

OR 

AL,30H 

:CONVERT TO ASCII 

291 

013A 

8A DO 

MOV 

DL,AL 

:SET UP DL VITH CHAR TO DISP 

292 

013C 

B4 02 

MOV 

AH,DISP_CHAR 

.;MSDOS FUNCTION CODE 

293 

013E 

CD 21 

INT 

21H 

:MSDOS CALL 
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Is the qane port in the sysiei? 


0140 

E8 017D R 

DC4: CALL 

CRLF 

;NE¥LIHE 

0143 

8D 16 0096 R 

LEA 

DX,GAME.PORT 

;GAME PORT IN SYS? 

0147 

B4 09 

HOV 

AH,DISP.LINE 

;FU|ICTI0N CODE FOR DSPL 

0149 

CD 21 

INT 

21H 


014B 

A1 0002 R 

MOV 

AX,HDIiRJYPES 

;GET CONFIGURATION CODE 

014C 

B1 OD 

MOV 

CL, 13 

;INITIALIZE ROTATE COUNT 

0150 

03 D8 

RCR 

AX,CL 

;IN SYSTEM? 

0152 

73 03 

JNC 

DC5 

;IF NOT, CONTINUE. 

0154 

C8 0174 R 

CALL 

YESJN.SYS 

;SAY IT IS ON DISPLAY 


•Atttttt How about printers? How eany? 


0157 

E8 017D R 

DC5; 

CALL 

CRLF 

;NEVLINE 

015A 

8D 16 00B9 R 


LEA 

DX,PRINTER 

•m MANY PRINTERS? 

015E 

B4 09 


MOV 

AH,DISP.LINE 

;FUNCTIOH CODE F(M? DSP 

0160 

CD 21 


INT 

21H 


0162 

A1 0002 R 


NOV 

AX,HDNRJYPES 

;GET STATUS NORD 

0165 

B1 OE 


NOV 

CL, 14 

.UNITIALIZE ROTAI^ COUNT 

0167 

D3 C8 


ROR 

AX,CL 

;IS IT IN THE SYS? 

0169 

24 03 


AND 

AL,0000001IB 

;NASK BITS 

016B 

OC 30 


OR 

AL,30H 

;CONVERT TO ASCII 

016D 

8A DO 


MOV 

DL,AL 

;SET UP DL FOR DISPLAY 

016F 

B4 02 


MOV 

AH,DISP,CHAR 

;msdos function call 

0171 

CD 21 


INT 

21H 


0173 

CB 

DONE: 

RET 



0174 


START 

ENDP 




;Procedure to show that the resource is available. 

immmtmmtttmmmtttmnmmttmmtntmm 


0174 


YESJN_SYS 

PROC NEAR 


0174 

8D 16 OlAF R 

LEA 

DX,IN.SYS 

.!Shon that is in the system 

0178 

B4 09 

MOV 

AH,DISP.LINE 

;NSDOS FUNCTION CODE 
;FOR DISPLAYING LINE 
;POINTS) TO BY DX 

017A 

CD 21 

INT 

21H 

.:M^S Vmum CALL 

017C 

017D 

C3 

RET 

YES IN.SYS 

ENDP 

; RETURN TO CALl£R 





^Carriage return linefeed procedure. Use a sieilar procedure, 
;or this one to generate a carriage retufn and a line feed 
;to iove the cursor to the 1st coluin of the next line 
;(a1so known as a new line function). 

•tmtmtmmmmttmmttmttmttmmmm 


017D 


CRLF PROC 

NEAR 

tNENLINE FUNCTION FOR 

mm 

017D 

B2 OA 

MOV 

DL,0AH 

:LINEFEED CODE 

017F 

B4 02 

MOV 

AH,DISP.CHAR 

:MSDOS FUNCTION CODE 
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346 




;T0 DISPLAY CHARACTER 

347 

0181 

CD 21 

INT 

21H ;MSD0S CALL 

348 

0183 

B2 OD 

HOV 

DL,ODH :CARRIAGE RETURN CODE 

349 

0185 

B4 02 

MOV 

AH,DISP.CHAR ;DISPLAY THE CHARACTER 

350 

0187 

CD 21 

INT 

21H 

351 

0189 

C3 

RET 


352 

018A 


CRLF HOP 


353 





354 





355 



■Atit PROCEDURE TO DISPLAY HQIORY SIZE - DX MUST K POINTING 

356 



■Am TO THE BEGINNING (F A MESSAGE STRING ENTRY. 

357 





358 

018A 


DISP,MESS 

PROC NEAR 

359 

0186 

B4 09 

HOV 

AH^DISP.LIHE ;384K of RAN in systeA 

360 

018C 

CD 21 

INT 

21H 

361 

018E 

E8 017D R 

CALL 

CRLF 

362 

0191 

C3 

RET 


363 

0192 


DISP_HESS 

ENDP 

364 



Ammmmmntmmmnmntttmmmmm 

365 





366 

0192 


MY.CODE ENDS 


367 



END 

INITl 
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Listing 6-1 
MACFLE.MAC 


-***** This file will establish furictiorial calls which can be 
;invoked through the use of a macro call. The Macros will 
;utilize the necessary registers, without saving the register’s 
;orevious contents- Therefore it is necessary for the drogrammer 
;to save any usable data prior to invoking the macro- 

sSee the DOS Technical Reference Manual (MSDOS or PCDOS) for 
;reqister usage. You must also INCLUDE DOSEQU.EQU when using this file. 

;Created 03/17/84 
;Last Updated: 10/03/84 
;By: Gary P. Shade 


BIOS EQU 10H ;BIOS VIDEO INTERRUPT. 

MSDOS EQU £1H ;MSDOS INTERRUPT 


.********************************************************* 
;THIS MACRO WILL TERMINATE A USER PROGRAM. 

sCS REGISTER MUST BE SET TO THE SEGMENT ADDRESS IN THE PSP 
;PRIOR TO INVOKING THIS CALL. SEE IBM TECHNICAL REFERENCE 
5 MANUAL PAGE 5-17. 

;Function 0 

©TERMINATE MACRO 

MOV AH,EXTERMINATE ^TERMINATE USlR PROGRAM 

INT MSDOS ;MSDOS CALL 

ENDM ; 

. ********************************************************** 

5THIS MACRO WILL WAIT FOR A KEY TO BE PRESSED AND ECHOES THE 
;CHARACTER TO THE DISPLAY. ON RETURN THE CHARACTER IS IN AL 
•IF A CONTROL-C IS TYPED, AN INT £3H IS EXECUTED. 

5 F unction 1 

©WAITKEY MACRO 

MOV AH,FxWAITKEY ;FUNCTION REQUEST 

INT MSDOS 5DOS CALL 

ENDM 

.********************************************************** 
;THIS MACRO WILL DISPLAY THE CHARACTER IN DL. 

5 

;Function 2 

©CHARDSP MACRO 

MOV AH,FxCHARDSP ;DOS FUNCTION CODE 

INT MSDOS 5 

ENDM 

;******************************************^^*************** 
;THIS MACRO WILL WAIT FOR A CHARACTER TO BE INPUT FROM THE 
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;AUX DEVICE. 

;Function 3 

GiWAITftUX MACRO 

MOV AH, F_^WAITAUX ;FUNCTION CODE 

INT MSDOS ;DOS CALL 

ENDM 

;********************************************************** 

;This macro will send the characterr in DL to the AUX device. 

;F»-inction 4 

C-AUXOUT MACRO 

MOV AH, F__AUX0UT 

INT MSDOS ?D0S CALL 

ENDM 

;********************************************************** 

sThis macro will out out a character in DL to the □v*'inter 
;if one is attached to the system. 

5 The character must be in DL before the macro is invoked. 

? 

;Function 5 
ePRINTER__OUT MACRO 

MOV AH,F^PRINTER^OUT ;MSD0S FUNCTION CODE 

INT MSDOS ;SYSTEM CALL 

ENDM 

;**********************•!<•*********************************** 
;This macro will return a keyboard character if one is ready. 
;If DL = 0FFH then the routine will return a character fov^rn the 
;Keyboard, if one is available (If AL= 00H on return, 

;no character was available. If DL does not = 0FFH, 

;then the routine will display the character in DL- 


5 Function 6 



C-CON 10 MACRO 

MOV 

AH,F CON 10 

;MSDOS FUNCTION CODE 

INT 

ENDM 

MSDOS 

;SYSTEM CALL 


;********************************************************* 

;This macro will wait for a character from the keyboard. 

;The routine does not check for a control ~ C. 

5 The character is returned in AL and is not echoed to the display. 
5 

;Function 7 

©CON INPUT MACRO 

MOV AH, F_.C0N_INPUT 

INT MSDOS 

ENDM 

;********************************************************* 

;This macro will wait for a keyboard character, and return 
5 it in AL without echoing the character to the disolay. 

;If a control ~c is Dressed, the routine executes 
;an interrupt (INT), £3H. 

5 

:Function 8 


C-CON INPUTS 


MACRO 
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MOV ftH,F_CON_INPUTS ;MSDOS FUNCTION CODE 

INT MSDOS ;MSDOS FUNCTION CPLL 

ENDM 

*****^(.*************************************************** 

Macro to display a line of information on the video disDlay. 

Uses DX and AH registers- 

The label of the message must be oassed to the macro as a 
parameter. 

The string must be terminated with a ’(£4H) 

All function codes (F_xhx) can be found in the equate file 
dos. equ. 


;Function 9 

©VDLINE MACRO MESSAGE 

MOV AH, F__VDLINE ;FUNCTION CODE FOR 

;LINE DISPLAY 

LEA DX,MESSAGE 

INT MSDOS 5 MSDOS CALL 

ENDM 

*********************************************************** 

;MACRO TO ACCEPT A LINE OF INPUT FROM THE KEYBOARD TERMINATED 
;BY A CARRIAGE RETURN. 

5 A KEYBOARD BUFFER MUST BE ESTABLISHED WHICH IS DEFINED AS 
;FOLLOWS: BYTE 0 = LENGTH OF THE BUFFER. 

; BYTE a = CHARACTERS ENTERED (RETUNED VALUE ) 

; BYTE 3 THROUGH N = BUFFER, WHERE N IS LAST BYTE 


Function 0AH 


C-KBDLINE 

MACRC 

1 KBDBUFFER 





MOV 

AH,F KBDLINE 

:GET 

DOS 

FUNCTION CALL 


LEA 

DX,KBDBUFFER 

;GET 

ADDRESS 0 ^ KBUFFER 


INT 

ENDM 

MSDOS 

-.EXECUTE 

CALL 


.********************************************************* 

;This macro invokes a routine to check for an available 
;character from the keyboard’s type ahead buffer. On return 
;AL = 0FFH, means there are characters in the buffer. 

5 AL = 00H then there are no characters in the buffer. 

;If the routine encounters a control~C, then INT 23H is 
;executed. 

5 

;Function 0BH 
0PEEK^BUFFER MACRO 

MOV AH,F^PEEK^BUFFER 5 MSDOS FUNCTION CODE 

INT MSDOS ;SYS. CALL 

ENDM 

;********************************************************** 
;This macro will clear the type ahead buffer and invoke 
5 the function whose code is in the AL register at entry. 

;The allowable functions are: 1, 6 , 7, 8 , 0A. If AL 
;contains any other value, only the buffer is cleared, and 
5 the routine takes no other action. 

;0n return AL will contain 00H,if the buffer was cleared, 
;and there was no other function executed. 


Function 0CH 
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©KBD^FLUSH MACRO FUNCTION 

MOV AH,F^KBD^FLUSH ;FUNCTION CODE 

MOV AL,FUNCTION ;READ FUNCTION 

5 IF ANY. 

INT MSDOS 5DO THE CALL 

ENDM 

;********************************************************* 
;This macro will invoke the routine which flushes all file 
;buffers by writing modified files to disk. The directory 
;is not updated, use the close function to uodate 
•the directory properly. 

5 Function 0DH 

©DISK RESET MACRO 

MOV AH,F DISK^RESET ;FUNCTIOM CODE 

I NT MSDOS ,-SYS. CALL 

ENDM 

;This macro will select the specified disk drive as the 
;default disk drive. The logical drive number is in DL 
• C0SS drive A, 1= drive B etc. 3. On return AL contains the 
;total number of disk drives in the system. See also BIOS 
;interrupt IIH which returns the equipment configuration for 
5 your computer- 

;The DRIVE_NUMBER parameter must be an capital ASCII letter 
;’A’ or *B’ etc. do not specify the drive number in lower 
;case. 

;Function 0EH 


DISK 

MACRO DRIVE NUMBER 


MOV 

AH, F_SELECT_DISK 

;FUNCTION CODE 

MOV 

DL,DRIVE NUMBERC-40H2 

;DRIVE LETTER 

I NT 

MSDOS 

;SYS. CALL 

ENDM 




********************************************************* 
This macro will invoke the MSDOS function which will ooen 
a disk file control block. DS:DX must point to the FCB. 
the FCB will be initialized as follows (assuming the file 
is found in the directory); 

BYTE in FCB Initialized to: 

0C-0D 0000H (Current Block Number) 

0E-0F 0080H (Record Size) 

10H-16H Set by directory information. 

(File Size (10H), date last updated (14H), and time last 
updated <16H), are set from information contained 
in the directory. 

After opening the file, set bytes 0EH~0FH in the FCB to 
the desired record size, 

byte 20H to the current record number (sequential access), 
byte 21H must be set to the relative record 
number (random access). 

On exit; AL = 00H then directory entry was found. 

AL = 0FFH then directory entry not found. 

Function 0FH 


C-OPEN MACRO FCB 

LEA DX,FCB 


;Get the FCB 
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MOV 

RH, F_OPEN 

5MSDOS FUNCTION CODE. 

INT 

MSDOS 

;INT 21H. 

ENDM 




********************************************************* 

This macro will close a file and uodate the directory- 
DS:DX must point to an open FCB. 

On return, ftL = 00H then entry was found in the directory. 

ftL = 0FFH then entry was not found in the directory 
F unction 10H 


MACRO 

FCB 

MOV 

AH,F CLOSE 

LEA 

DX,FCB 

INT 

MSDOS 

ENDM 



********************************************************* 
This macro will search a directory for the first entry 
which matches the file name specified in the FCB. 

If it is found, an unopened FCB of 

the same type will be created at the disk transfer address. 
See the IBM Technical Reference Manual for a description 
I of this function. 

DS:DX Must point to an unopened FCB of the file to 
1 search the directory for. 

On exit ftL = 00H if the directory entry was found. 

[ AL = 0FFH if the directory entry was not found. 


Function IIH 


C-DI RESEARCH 
LEA 
MOV 
INT 
ENDM 


MACRO FCB 

DX,FCB ;POINT TO THE FCB 

AH,F_DIRESEARCH ;MSDOS FUNCTION CODE 
MSDOS ;SYSTEM CALL 


.********************************************************* 

•,This macro will invoke the MSDOS function to search the 
;directory for the next entry which matches the file name 
;specified in the FCB. It is normally used after the 
;0DIR_SEARCH. If the file name specified in the unopened FCB 
;matches an entry in the directory, an unopened FCB is created 
;at the DTA. 

;If on return AL = 00H then the entry was found in the directory. 
;If AL = 0FFH, then the entry was not found. 

;See page 5-23 of the IBM Technical Manual for a complete 
;descript ion of this function. 

5 Function 12H 

©SEARCH^NEXT MACRO FCB 

LEA DX,FCB 

MOV AH,F SEARCH^NEXT 

INT MSDOS 

ENDM 


;DOS FUNCTION CODE 
;SYS. CALL 


• ********************************************************** 
;This macro will invoke the MSDOS function which will 
;delete all entries matching the file spec contained in the 
;FCB pointed to by DS:DX. 

;0n return AL = 00H then entry found. 

;If AL = 0FFH then the entry was not found. 

;See IBM Technical Reference Manual page 5-23. 

;Function 13H 
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C-DELETE^FILES MACRO FCB 

LEA DX,FCB 

MOV AH, F_.DELETE_F ILES 

INT MSDOS 

ENDM 

*********************************************************** 

;This macro will read a secueritial record. The record read 
;will be the one specified by the current block (byte 0CH of 
;the FCB, and the current record (byte 20H of the FCB). The 
;record is transferred to the DTA. The record size is specified 
;by the value contained in byte 0EH of the FCB. 

;DS;DX must point to the FCB on entry to this function. 

;0n return, AL = 00H then read was successful. 

; 01H then EOF was encountered; No data in record- 

; 02H DTA contained insufficient space to 

; read a record. Operation canceled. 

; 03H EOF encountered, partial record read, 

; record padded with zeros. 

;Function 14H 

C-READ^SRECORD MACRO FCB 

LEA DX,FCB ;POINT TO THE FCB. 

MOV AH,F^READ^SR£CORD ;MSDOS FUNCTION CODE 

INT MSDOS ;SYS. CALL 

ENDM 

;************************************************************** 
;This macro will write a sequential record to disk. 

;0n entry, the opened FCB must be pointed to by DS:DX 
;on exit, AL = 00H write was successful. 

; 01H disk was full, operation canceled. 

; 0£H there was not enough room in the DTA 

; operation canceled. 

5 Function 15H 

C-WRITE^SRECORD MACRO FCB 

LEA DX,FCB ;POINT TO FCB 

MOV AH,F_WRITE_SRECORD ;WRITE FUNCTION CODE 

INT MSDOS 

ENDM 

;******************************************************** 

;This macro will invoke the MSDOS function to Create a file 
;or it will erase the contents of an existing file and 
;the FCB is opened for the new file. 

;DS:DX must point to the unopened FCB. 

;0n return, AL = 00H then an empty directory entry was found. 

; 0FFH then an empty directory entry was not found. 

;Function 16H 

C-CREATE FILE MACRO FCB 

LEA DX,FCB ;MOVE FCB TO DX 

MOV AH,F^CREATE^FILE ;MSDOS FUNCTION CODE 

INT MSDOS ;SYS. CALL 

ENDM 

;*********************************************************** 

;This macro will invoke the MSDOS function to rename an existing 
;file. The current drive and filename are located in the FCB 
;at bytes 00 = current disk drive- 
; 01-08 = file name 

; 09-0BH = file name extension 

;DS:DX-H1H = START OF NEW FILENAME. 

;0n return, AL = 00H = Success 
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; 0FFH = No directory entry or match found. 

;Function 17H 

C-RENftME_FILE MfiCRO FCB 
LEft DX,FCB 

MOV PH,F_RENfiME_FILE ;FUNCTION CODE 

INT MSDOS 

ENDM 

.********************************************************* 

;This macro will fetch the code of the currently selected 
;disk drive. The code is returned in AL as 00 = ’A’, 01 = ’B’ 
;etc. 

;Function 19H 
©CURRENT DISK MACRO 

MOV AH,F^CURRENT^DISK ;MSDOS FUNCTION CODE 

INT MSDOS ; 

ENDM 

.******************************************************** 

;This macro set the disk transfer address to the address 
;supplied in DS:DX. 

;If this function is not set then the default DTA at 60H 
;in the PSP is used. 

5 Function lAH 

©SET DTA MACRO DTA 

LEA DX,DTA ;MOVE ADDRESS OF DTA TO DX 

MOV AH,F^SET^DTA 

INT MSDOS 

ENDM 

.********************************************************* 

5 This macro will invoke the MSDOS function to read 
;the File Allocation Table information. On return, DS:BX 
;points to the FAT byte containing the default drive. 

;DX contains the number of allocation units 

;AL contains the number of sectors per allocation unit, and 
;CX contains the size of the physical sector. This is only 
5 true for MSDOS version 1.0- For MSDOS 2.0 and 2.1 use function 
;3&H 
5 

5 Function IBH 

©GET FAT MACRO 

MOV AH,F^GET^FAT 
INT MSDOS 

ENDM 

;This macro will invoke the random record read function of 
;MSDOS. DS:DX must point to an opened FCB for the file to 
;be read. 

;0n return AL = 00H then read was successful 

; 01H then EOF, no data returned- 

; 02H then DTA contained insufficient space 

- to read a record- Operation aborted- 

; 03H then EOF encountered, partial record 

; read and padded with zeros. 

;Function 21H 

©READ RRECORD MACRO FCB 

LEA DX,FCB 

MOV AH,F READ^RRECORD 

INT MSDOS 

ENDM 

.****#**********#***************************************** 

;This macro will invoke a function to write a random record 
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;to disk. The current block (FCB + 0CH), current record 
;(FCB + 20H) are set according to the relative record field 
5 <FCB 4 - 21H). The record written is'contained in the DTfi. 

;See'page 5~26 of the IBM technical reference manual for 
;further information. 

5 

;Function 22 H 

C-WRITE_,RRECORD MPCRO FCB 

LEA DX,FCB ;MOVE FCB INTO DX 

MOV AH,F__WRITE^RRECORD 
INT MSDOS 
ENDM 

;*********************************************************** 
;This function will invoke the MSDOS function to determine 
;the number of records in a file. The filename in contained 
;in an unopened FCB. YOU MUST SET THE FCB RECORD SIZE FIELD 
5 <FCB + 0EH) BEFORE USING THIS FUNCTION! 

5 The FCB must be unopened. 

5 On return AL = 00H means the directory entry was found. 

• PL = 0FFH means the directory entry was not found. 

;Function 23H 

©GET^FILE SIZE MACRO FCB 

LEA AH,F_GET_FILE SIZE 
MOV DX,FCB 

INT MSDOS 

ENDM 

;*********************************************************** 
;This macro will set the relative record for random file access. 
;The relative record field (FCB + 21H) is set to the same 
;address as the current block (FCB + 0CH), and current record 
;field (FCB + 20H). 

;DS:DX points to an open FCB 
;Function 24H 

@SET REL^RECORD MACRO FCB 
LEA DX,FCB 

MOV AH,F SET REL RECORD 

INT MSDOS 

ENDM 

;*****************#*-l(^*#*********-lt-************************* 

;This macro will set a new interrupt vector for the 
;specified type. 

5 AL = TYPE number of interrupt to set vector for. 

;DS:DX =4 byte interrupt handler address. 

5 

;Function 25H 

eSET_INT_VECTOR MACRO TYPE,SEG^VECTOR,OFFSET^VECTOR 

PUSH DS ;SAVE OLD DATA SEG. 

MOV AX,SEG VECTOR ;GET SEGMENT ADDRESS 

MOV DS,AX ;PUT INTO DS 

MOV DX,OFFSET_VECTOR ;GET OFFSET INTO SEGMENT 

MOV AL,TYPE 

MOV AH,F SET^INT^VECTOR ;MSDOS FUNCTION CODE 
INT MSDOS 

POP DS ;RESTORE OLD DATA SEG. 

ENDM 

********************************************************** 
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;This macro will perform a random block read- 

;CX contains the number of records to be read 

;DS:DX point to the open FCB- 

$0n return CX = number of records read- 

5 If ftL = 00H then block read was successful. 

; 01H then EOF encountered, last record intact. 

; 02H address wrap above FFFFH in DTA 

; 03H EOF encountered last record only partially read 

5 Function 27H 

C-BLOCK^RREPD MACRO FCB, REC_COUNT, RECORD^SI ZE 

LEA DX,FCB ;Point to FCB 

MOV CX,REC_COUNT ;How Many records? 

MOV FCBi:0EH3, RECORD SIZE ;And what Size? 

MOV AH,F BLdCK^RREAD 

INT MSDOS 

ENDM 

.********************************************************* 

;This macro invokes the random block write function 
5 under MSDOS control. See IBM technical reference manual 
;Page 5-29 for a description of this function- 
;CX * number of records to write 

;If CX is zero on entry, then file size is set according to 
;the random record field and the logical record size. 

;DS:DX = pointer to FCB 

;0n return, AL = 00H block write was successful 

; 01H = no records written because disk is full- 

;Function 28H 
5 

0BLOCK_RWRITE MACRO FCB,REC^COUNT,RECORD^SIZE 
LEA DX,FCB 

MOV CX,REC_COUNT 

MOV FCBC0EH3,RECORD^SIZE 

MOV AH,F^BLOCK^RWRITE 

INT MSDOS 

ENDM 

. ^^(.^(.^^(.^f^f*********************************************** 

5 This function will parse a string for a specified filename. 

;See page 5-28 of the IBM technical reference manual for a 
;descript ion of this function. 

5 

;DS:SI point to the command line to parse 

$ES:DI point to a portion of memory to be used as the FCB 
5 Bits 0-3 of AL are used to control the parsing. 

; BIT 0 = 0 = Stop parsing if a file separator encountered- 
. = 1 5s Ignore file separators. 

5 BIT 1=0= Set drive in the FCB to default drive (0) 

; if the string does not contain a drive number. 

• 1 = Default Drive is not changed if the string 

5 does not contain a drive number. 

; BIT 2 = 0 = Do not change the filename in the FCB if the 
; string does not contain a name. 

- 1 = Change file name in FCB if string contains 

; a file name. 

; BIT 3 = 0 = The file extension in the FCB is not changed 

; if the string does not contain an extension. 

; 1 = Change the extension if the command line contains 

5 an extension. 
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;Function 29H 


STRING 

MPCRO NPME^STRING,FCB PREP, PPRSE BITS 

LEP 

SI,NPME STRING 

;STRING TO PPRSE 

LEP 

DI,FCB PREP 


PUSH 

ES 

;SPVE SEG REGISTERS ES PND 

PUSH 

DS 


POP 

ES 

;SET ES = DS 

MOV 

PL,PPRSE BITS 

;HOW DO WE PPRSE? 

MOV 

PH,F^PPRSE STRING ; 

I NT 

MSDOS 


POP 

ES 

;Restore seg register 

ENDM 




;********************************************************* 
;This macro will invoke the MSDOS function to read the 
;date and return the date in the following registers; 

;CX: = Year in binary 

;DH: = Month in binary (1 = Jan. etc. ) 

;DL: = Day of the month in binary 


MftCRO 

PH,F^GET^DPTE 
MSDOS 


©BET^DPTE 

MOV 
I NT 
ENDM 

********************************************************* 

This macro will set the date according to the binary information 
contained in the registers as follows. 

CX: * Year 

DH: = Month (1 = Jan- etc.) 

DL: = Day of the month 

On return PL = 00H then the date code was valid. 

PL = 0FFH then the date was not valid, operation 
aborted. 


MPCRO YEPR,MONTH,DPY 

PH,F_SET_DPTE ;GET MSDOS FUNCTION CODE 

CX,YEPR ;LOPD YEPR IN CX 

DH,MONTH ;MONTH IN DH 

DL,DPY 

MSDOS 


Function 2BH 

C-SET DPTE 

MOV 
MOV 
MOV 
MOV 
I NT 
ENDM 

;********************************************************* 
;This macro will get the current time and return it in the 
;registers as depicted below. 

;CH: = Hour (£4 hour format) 

;CL: = minutes 
;DH: = Seconds 

;DL! = hundreths of a second 


;Function £CH 

C-GET^TIME 

MOV 
I NT 
ENDM 

;********************************************************* 
;This macro will invoke the MSDOS function to set the time 


MPCRO 

PH,F_GET_TIME 

MSDOS 
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jThe following registers are used to soecify the time on 
{invoking this function. 

{CH: = HOUR <24 HOUR FORMfiT) 

;CLs = MINUTES 
;DHi = SECONDS 

{DL: = HUNDRETHS OF ft SECOND 
;FORMRT SDH 

eSET TIME MACRO HOUR,MINUTES,SECONDS,HUNDRETHS_SEC 

MOV nH,F_SET_TIME 

MOV CH,HOUR 

MOV CL,MINUTES 

MOV DH,SECONDS 

MOV DL,HUNDRETHS_SEC 

INT MSDOS 

ENDM 

; *********************************************************** 

;This macro will set the verify flag used when writing data 

;to disk. When on, it causes a verify ooeration after each 
;write. On entry ftL = 00H then do not verify, 

• 01H then verify. 

;Function 2EH 

C-VERIFY^WRITE MACRO ON^OR^OFF 

MOV AH,F VERIFY 

MOV AL,ON^OR^OFF 

INT MSDOS 

ENDM 

;********************************************* 

5 This macro will return a pointer to the DTA. 

5 ES:BX will contain the pointer on return. 

5 

5 Function 2FH 

©GET DTA MACRO 

MOV AH,F^GET^DTA 

INT MSDOS 

ENDM 

************************************************ 

;This macro will get the version number of MSDOS. 

;On return AL contains the major revision level, and AH 
;will contain the minor rev. number. 

5 

5 Function 30H 

©GET^VERSION MACRO 

MOV AH,F^GET^VERSION 

INT MSDOS 

ENDM 

.********************************************************* 
;This macro will invoke the MSDOS terminate/keeo resident 
;function. See page 5-31 of the IBM DOS Technical Reference 
5 Manual. On return, DX contains the memory size in paracraDhs. 
5 AL = exit code. 

5 

;Function 31H 

©TERMINATE^RESIDENT MACRO MEM_SIZE,EXIT^CODE 

MOV AL,EXIT^CODE 
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MOV DX,MEM_SIZE 

MOV «H,F_TERMINPTE RESIDENT 

INT MSDOS 

ENDM 

;This macro will invoke the MSDOS function to either 
;read the current state of -"'C (Control C> checking 
; (ON/OFF) or to set the state of •''C checking. If the state 
;is set to ON, then functions 06H and 07H cannot be used. 

;If ftL = 00 then the current state is returned in DL which is: 

500 * off, 01H = ON. 

5 If ftL *01 then set the state as defined by the contents of DL 
5 (00H * Set checking Off which is the default state) 

5 (01H = Set -^C checking On) 

5 (Jse this function to enable Control C checking during all ooerations. 


5 Function ^3H 

©SET^C^CHECK MACRO SWITCHl, SWITCHS 


LOCAL 

FETCH 

MOV 

AL,SWITCHl 

OR 

AL 

JZ 

FETCH 

MOV 

DL,SWITCH2 

FETCH: MOV 

AH,F SET C 

I NT 

MSDOS 

ENDM 



5 SET OR FETCH? 

5 SET FLAGS 

5 Z, THEN GET CURRENT STATE 
5 ELSE LOAD DL WITH ON OR 
5 OFF. 

5 MSDOS FUNCTION CODE 


5 This macro will return an interrupt vector for a given 
5 interrupt type. Use this call to retrieve a vector and 
5 function call 25H to set a vector. The old vector read by 
5 this function should be saved and restored prior to exitinp 
5 a user program and returning to DOS. 

5 AL contains the interrupt number on entry. 

5 And ES:BX contain the vector on return. 


5 Function 35H 

©READ^VECTOR 
MOV 
MOV 
I NT 
ENDM 


MACRO TYPE 
AL,TYPE 

AH,F^READ^VECTOR 
MSDOS 


;This macro will invoke the MSDOS function which returns 
5 the amount of free space remaining on a disk (in BX). 

5 It also returns the total number of allocation units on the 
5 drive(in DX), bytes per sector (in CX), Sectors per allocation 
;unit (in AX). 

5 If AX contains 0FFFFH on return then the drive number was 
5 invalid. This call is to be used instead of function IBH for 
5 DOS 2.0. 


5 Function 36H 

©GET^FREE^SPACE MACRO DRIVE 

MOV DL,DRIVE ;GET DRIVE NUMBER (0=A ETC.) 

MOV AH,F GET^FREE SPACE 
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INT MSDOS 

ENDM 

.********************************************************* 

;This macro will create a sub-directory at the end of a 
;user supplied path name- 

;DS:DX must point to an fiSCII string terminated with a null 
;00H byte (fiSCIIZ string). The string must contain drive and 
; pathname. 

;0n return if the carry is set, fiX contains an error code: 

;If fix = 03H then the pathname was not found. 

;If fix = 05H then access was denied to the parent directory. 

;Function 39H 

eWK^DIR MACRO PATH^NAME 

LEA DX,PATH^NAME 

MOV AH,F_MK DIR 

INT MSDOS 

ENDM 

********************************************************** 

;This macro will remove a directory entry from the parent- 
5 DS:DX point to the ASCIIZ pathname. 

;0n return if the carry is set, there was an error- The 
;error value in AX is the same as for function above, 

;with the addition of 10H which would mean that the path specified 
5 was the current directory of on a drive- 
5 

;Function 3AH 

eRM^DIR MACRO PATH_.NAME 

LEA DX,PATH^NAME 

MOV AH,F RM^DIR 

INT MSDOS 

ENDM 

.********************************************************* 

;This function will change the current directory. 

;DS:DX points to an ASCIIZ string which contains the new 
;directory name- If on return the carry flag is set, 

;AX will contain an error code- 03H means that the pathname was 
;not found, or was not valid- 
5 

;Function 3BH 

eCH_DIR MfiCRO PfiTH_NfiME 

LEfi DX,PfiTH NfiME 

MOV fiH,F_CH_DIR 

INT MSDOS 

ENDM 

;********************************************************* 

;This macro will invoke a function to create a file- 

;The file is created if not found in the directory, 

;or set to a null file (sets length to zero) if the entry 
;already exists in the directory. 

;DS:DX point to the ASCIIZ path name and CX contains 
;the file attributes: 

;01 = set = read only 
•02 = set = hidden file 
;04 = set = system file 

;08 = set = entry contains the volume label 
-10H = set = entry defines sub-directory 
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;£0H = set = set whenever the file has been written to and closed. 
;File attributes can be combined. 

; 0 n return if the carry is set, flX will contain an error code 
;as follows: 03 = path name not found (invalid) 

; 04 = Too many open files. 

; 05 = ^)ccess denied 

5 If the carry is not set, the operation was successful, and 
;ftX will contain a file handle number which is required 
5 For future file access functions. 


Function 3CH 


C-CREfiTE_FILE^£ 
LEA 
MOV 
MOV 
I NT 
ENDM 


MACRO PATH__NAME, ATTRIBUTES 
DX,PATH^NAME 
CX,ATTRIBUTES 
AH,F_CREATE FILE_£ 

MSDOS 


********************************************************* 
This macro will open a file. AL contains the desired 
access code as follows: 

00 = file is to be opened as read only. 

01 = the file is opened as write only. 

0 £ = the file is opened as read/write. 


DS:DX points to an ASCIIZ pathname. 

The record size is initialized to 1 byte, and the R/W pointer 
to the first byte of the file. 

On return if the carry is set, AX contains an error code as 
follows: 0£ = File not found 

04 = Too many open files 
05 « Access denied 

1£ * Invalid Access (Code in AL not between 0 ~£) 

If the operation was successful, then AX will contain a 
16 bit file handle which must be used to access the file 
during subsequent operations. 


©OPEN^FILE £ 
LEA 
MOV 
MOV 
INT 
ENDM 


MACRO PATH^NAME,ACCESS 

DX,PATH^NAME 

AL,ACCESS 

AH,F OPEN^FILE^£ 

MSDOS 


;****♦********************#******************************* 
5 This macro will close a file. 

5 BX must contain the file handle number of the file to be 
;closed. 

5 On return, if the carry is set there was an error and the 
;error code 06 will be in AX which indicates the file handle 
;was not for an open file. 




;Function 3EH 


©CLOSE^FILE £ 

MACRO HANDLE 

MOV 

BX,HANDLE 

MOV 

AH,F CLOSE FILE £ 

INT 

MSDOS 

ENDM 



is set 
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**************************************************************** 
This macro will read from a file or device. 

DS:DX points to a buffer for the ooeration. 

CX = the number of characters to read. 

BX = file handle number 

Not all characters specified in CX need be read. See oage 5 
of the IBM DOS technical reference manual, 
this function. 

On exit if the carry flag is set^ then AX will contain 
an error code as follows: 

05 = Access denied. 

06 = Invalid Handle ^ ^ 

If the carry is not set then AX will equal the number of bytes 
read from the file or device. 


Function 3FH 


©READ FILE 2 
LEA 
MOV 
MOV 
MOV 
I NT 
ENDM 


MACRO HANDLE,BUFFER,BYTES 
DX,BUFFER 
BX,HANDLE 
CX,BYTES 

AH,F READ FILERS 
MSDOS 


************************************************************** 
This macro will write a specified number of bytes to a file 
or to a device. DS:DX must point to the buffer from which the 
data is transferred, CX contains the total number of bytes to 
write to the file, and BX must contain the file handle number. 

On return, if the carry is set then AX will contain an error code 
number as in the read function above (function # 3FH)- 


If the carry is not set then AX equals the number of bytes written 
to the file or device. 


;F unction 40H 


©WRITE FILE 2 

MACRO BUFFER,HANDLE, 

LEA 

DX,BUFFER 

MOV 

AH,F WRITE FILE 2 

MOV 

CX,BYTES 

MOV 

BX,HANDLE 

INT 

MSDOS 

ENDM 



;****************************************************************** 
;This macro will invoke the MSDOS function to delete a directory 

;entry. DS:DX must point to the pathname of the entry to delete. 

;If the carry is set on return, there was an error. AX will contain 
;one of the following error codes: 02 == File not found. 

- 05 = Access denied. 

5 This function only will work on files that are closed, and 
;have the proper attributes (i-e. R/W). 

;Function 41H 

@DELETE__FILE_2 MACRO PATH NAME 
LEA DX, PATH^NAME"" 
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MOV AH,F_DELETE FILE 3 

INT MSDOS 

ENDM 

;*********#***************##*********#********^(.******* 

5 This macro will move the do inter which is used 

;for read and write operations into the soecified file 

;by 1 of 3 methods. 

;If AL = 0 then the pointer will be moved the specified 
; numbeh of bytes (in CXzDX) from the becinning of 

; the file (absolute seek)^ 

;If AL = 1 then the file pointer will be rnoved the 
; specified number of bytes (in GXzDX) from 

; the current oointer position. 

;If AL = c! then the file pointer will be moved the 
; specified number of bytes (in CX:DX) from 

; the end of the file. Use an offset of zero 

5 to determine the end of the file. 

;CX and DX must contain the distance to move the pointer in pyt 
; (CX = MSW^ DX = LSUO. 

;AL = type of moye. 

;BX = file handle. 

5 On return if the carv-y is not set, then the operation was 
5 successful and DXsAX contains the new pointer position. 

;If the carry is set, then AX contains an error code as follows 
;AX = 01 then the value in AL was not in the range of 0-2. 

•AX = 06 then the handle was invalid (an unopen file). 

;Function 42H 

©MOVE^POINTER MACRO MSW^DISTANCE,LSW DISTANCE,TYPE,HANDLE 

MOV CX,MSW^DISTANCE ;HIBH ORDER WORD FOR DISTANCE 

MOV DX,LSW^DISTANCE ;LOW ORDER WORD FOR DISTANCE 

MOV AL,TYPE 5 HOW WE MOVE THE POINTER 

MOV BX,HANDLE ;HANDLE NUMBER OF OPEN FILE. 

MOV AH,F^MOVE^POINTER 

INT MSDOS 

ENDM 

;************4f****************4f*****************-i(-********* 

;This macro will invoke the MSDOS function to either read 
;a file’s attributes or chance them as defined by the contents 
;of CX. 

;AL contains!. 00H to r^ead the file attributes^ or 
; 01 H to set the_attributes. 

;DS:DX must point to the files path name. 

;If the attributes are read, then they are returned in 
;the CX register (if there were no errors during the operation). 
;If an error occurred, the carry bitwill be set and AX will 
;contain one of the following error codes. 

;If AX = 1 then the value in AL on entry was not 00 or 01H 

; AX = 3 then the path name was invalid. 

; AX = 5 then access was denied. 

5 

;Function 43H 

0CHfiNGE_flTTRIBUTES MACRO PATH_NAME,ATTRIBUTES,TYPE 

LEA bX,PATH NAME 

MOV CX,ATTRIBUTES 

MOV AH,F_CHfiNGE_ATTRIBUTES 

MOV AL,TYPE 
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I NIT MSDOS 

ENDM 

;******************************************************** 
;This macro will duplicate a file handle of an open file. 
;BX = file handle number to be duplicated 

;Function 45H 


@DUP HPNDLE 

MRCRO HfiNDLE 

MOV 

BXjHRNDLE 

MOV 

RH,F DUP HRNDLE 

INT 

MSDOS 

ENDM 



. *****^(.*************************************************** 

;This macro will point an existing file handle to a new file. 

;CX = new file handle number 
;BX = existing file handle number 
;Qn return: 

;If the carry is set then ftX contains an error code as follows: 

-04 = Too rnany files open. 

;06 = Invalid handle. 

5 If the caY'ry is not set, both handles will point to the same 
;(new) file. 

;F unction 46H 

@DUP_HftNDLE_£ MftCRO OLD^HftNDLE,NEW^HPNDLE 
MOV CX,NEW_HANDLE 

MOV BX,OLD_HANDLE 

MOV PH,F^DUP^HPNDLE^S 

INT MSDOS 

ENDM 

. ************************************************************* 

;This rnacY'o will get the cuY'rent directoY^y (the full path) 

5 and read it into a 64 byte buff by' pointed to by DS:SI. 

;DL must contain the drive number (0=ft etc.) 

50 n Y-'eturn DS:DI will point to the buffeY-' containing the 
;diY'ectoY-'y. 

;If the carY'y is set then an error occurred in that the CY'ive 
;specified in DL was invalid (PX = 15H) 

? 

5 Function 47H 

©CURRENT^DIR MPCRO BUFFER,DRIVE^NUM 
MOV DL,DRIVE^NUM 

LEP SI,BUFFER 

MOV PH, F__CURRENT_,DI R 

INT MSDOS 

ENDM 

.************************************************************ 

;This macro will invoke the MSDOS function to return a pointer 
;to a free block of memory of a specified size. 

; (PI most sounds like multitasking!) 

5 BX contains the amount of memory to be allocated (in paracY^aphs). 

; 0 n return the carY^y will be set if there was an error and 
;PX contains 07 then the memory control blocks were destroyed. 

• 08 = Recuested size largeY' than availaole RPM. 

;BX will contain the maximum size that was allocated (in paragraphs). 
;If the carry is not set on retuY'n, then the operation was 
;successful, and PX contains the pointer to the allocated block. 



Listing 6-1 continued 

;Furictiori 48H 
5 

©PLLOCftTE^MEM MACRO BLOCK^SIZE 

MOV BX,BLOCK_SIZE 

MOV AH^ F ALLOCATE^MEM 

INT MSDOS 

ENDM 

;****** 4 ************************************************** 

;This micro will return (deallocate) a block of memory 
;which was previously allocated. 

;Ori entry, ES must contain the segment address of the block to 
;be ret urned. 

;0n returning from the routine, if the carry is set then 
;AX will contain one of the following error codes: 

;AX = 07 then memory control blocks were destroyed. 

;AX = 09 then the block contained in ES was not one 
; allocated through the AlLOCATE_MEM (ASH) function. 

;If the carry bit is not set, then the operation was successful. 

5 

;Function A9H 

C-DEALLOCATE_.MEM MACRO BLOCK^NUM 
MOV ES,BLOCK^NUM 

MOV AH,F DEALLOCATE^MEM 

INT MSDOS 

ENDM 

;********************************************************* 

;This macro will invoke the MSDOS function which modifies 
;an allocated block of memory. ES must contain the segment of 
5 block to modify, and BX contains the new block size (in oaragraohs). 
;If the new size of the block is less than that which is allocated, 
;then MSDOS will attempt to reduce the size of the block. If the 
;requested block size is lat'ger than that which is already 
;allocated then MSDOS will attempt to enlarge the amount of 
;memory allocated. Microsoft refers to this process as 
;"shrinking", or "growing" allocated memory blocks. 

;0n return of the carry is set then AX will contain an error 
;code as follows: 

5 AX = 07H then Memory Control Blocks were destroyed. 

; 08H then there was not enough memory to enlarge the block. 

; 09H then the block specified in ES was invalid. 

;BX will also contain the maximum memory (in paragraphs) that 

;is available if the specified block size was unavailable (AX = 07). 

5 If the carry is not set, then the operation was successful. 

;Function AAH 

C-NEW_BLK__SIZE MACRO NEW^SIZE, OLD^BLOCK 

MOV ES,OLD^BLOCK 

MOV BX,NEW SIZE 

MOV AH,F NEW^BLK^SIZE 

INT MSDOS 

ENDM 

;*****#*** 4 **************************************************** 

;This macro will load and/or execute a program. 

;0n entry DS:DX will point to the pathnarne~of the file to load 
;and/or execute. The pathname must be in ASCII and terminated 
;with a null byte (00H). ES:BX must point to a parameter block 
;(See IBM Technical Reference Manual page 5-43). AL must contain 
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5 the function code (00 = load and execute the program, 

;03H = load the orograrn, do not begin execution- 

;ftgain, see the IBM DOS Technical Reference Manual for a complete 
5 description of this function- 


;Function 4BH 


Cs-LOAD EXECUTE 
LEft 
LEfi 
MOV 
MOV 
I NT 
ENDM 


MACRO PATH_NAME,PARAM^BLK,FUNCTION 

DX,PATH^NAME 

BX, PARAM__BLK 

AL,FUNCTION 

AH,F^LOAD^EXECUTE 

Msbos 


*******************•»(.******************************************* 
This macro will terminate the current process. Control is returned 
to the process which invoke the terminated one- AL is used to 
return a code to the parent process- 

This operation will also close any and all open files. 


;Function 4CH 


©EXIT MACRO 

RETURN CODE 

MOV 

AL,RETURN CODE 

MOV 

AH,F EXIT 

INT 

MSDOS 

ENDM 



. *^i.************************************************************* 

•This macro will retrieve the return code of the child process 
;which terminated via the ©EXIT function (4CH). 

•A non-multitasking child process which is executed using the 
;©LOAD_EXECUTE function <4BH), will terminate using the 
;©EXIT function (4CH)- The ©EXIT function returns a one byte 
•return code on execution. This code can be used to convey 
•status information from the child process to the parent process. 
•Therefore, the parent program should use the ©GET_RET_CODE function 
•to retrieve this status byte passed from the child process. 

;This function can only be used once to obtain the return code- 
•On return, AL will contain the return code, and AH will contain 
;another code as follows: 

-AH = 00 = Child process terminated/aborted (normal return) 

. 01 = A control C caused process termination- 

; 02 = A critical error has occurred. 

- 03 = If the child process was terminated via 

; the ©TERMINATE^RESIDENT function (31H). 

;Function 4DH 

©GET RET__CODE MACRO 

MOV AH,F_GET_^RET_CODE 

INT MSDOS 

ENDM 

-************•><•************************************************** 
;This macro will invoke the MSDOS function which will find the 
•first matching pathname (dri ve/path/f i lenarne) which has the 
;attributes specified in the CX register. This function is 
;described on page 5-46 of the IBM DOb Technical Reference Manual. 
•The function will create a data block of information about the file 
■in the DTA- DS:DX must point to the pathname on entt'y- 
;0n return, if the carry is set then AX contains an error code 
;as follows: 
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ftX = 0£ then the pathname was invalid- 
ftX = 18 then there were no files found. 


Function 4EH 


©FIND^FILE 

MOV 

LE« 

I NT 
ENDM 


MftCRO PflTH__NfiME, ATTRIBUTES 
CX,ATTRIBUTES 
DX,PATH^NAME 
MSDOS 


************************************************************* 


;************************************************************* 
;This macro will find the next file with matching oathname 
;and attributes. It is used after the »f'FIND_FILE~funct ion ( 4 EH). 
;If the carry is set and AX contains iSH on return 
;then there were no more files found. 

5 

5 Function 4FH 

©FIND^NEXT^FILE MACRO 

MOV AH, F_.FIND_NEXT_^FILE 

INT MSDOS 

ENDM 


;************************************************************* 
;This macro will read the verify flag and return it’s status in 
5 AL. If AL = 00H then the verify flag is off. 

;If AL = 01H then the verify flag is on. 

5 

;Function 54H 

C-READ^ VERI FY^FLAG MACRO 

MOV AH, F READ_V£RIFY__FLAG 

INT MSDOS 

ENDM 

;************************************************************* 
;This macro will invoke the MSDOS function to rename a directory 
;entry. DS:DX must point to an ASCI IZ string wnich contains the 
;pathname of the file to be renamed. ES:DI Doints to the new 
: pathname of the file, "^he cisk soeci f icat ion must be the same 
;In both the old and new pathnames. 

;0n return if the carry is set then an occurred and AX contains 
;the error code as follows: 

;If AX = 3 then the pathname specified by DS:DX was not found. 
;If AX = 5 then access was denied either to the source or 
5 destination file. 

;If AX = 17 then the source and destination pathnames exist 
; on different drives. 


Function 56H 


©RENAME FILES 
LEA 
LEA 
MOV 
I NT 
ENDM 


MACRO SOURCE,DESTINATION 

DX,SOURCE 

DI,DESTINATION 

AH,F^RENAME^FILES 

MSDOS 


;*************************************************************** 
5 This macro will invoke the MSDOS function to read or set the date 
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;arid time stamp of the last write for a specified file- 
;The file’s handle must be in BX on entry, and the desired 
; function code in ftL (00H = get date and time, 0.tH = set cate 
;and time). CX will contain the time to be set and DX will 
;contain the date to be set. 

;If the function specified was to read the date and time, 

;then CX will contain the time and DX will contain tne date 
;of the last write operation, on return from the function. 

;If the carry is set on return then AX will contain an error code 
;as follows: 

;AX = 01 then the argument in AL on entry was invalid, it was 

• not 00 or 01H. 

;AX = 06 then the file handle passed in BX was invalid. 

;Function 57H 

@GET_SET_DT MACRO FUNCTION,HANDLE,TIME,DATE 

MOV AL,FUNCTION 

MOV BX,HANDLE 

MOV CX,TIME 

MOV CX,TIME 

MOV DX,DATE 

MOV AH,F^GET^SET^DT 

INT MSDOS 

ENDM 

.*************************************************************** 

.************************************************************** 

!******** VIDEO DISPLAY MACROS ********************* 
;******** USING BIOS CALLS FOR VIDEO CONTROL ********** 
;******** BIOS INTERRUPT TYPE: 10H 

;POSSIBLE ATTRIBUTE BYTES AS DEFINED IN IBM TECHNICAL 
;REFERENCE MANUAL ARE: 

;B7 B6 B5 B4 B3 BE B1 B0 

-’b R G B I R G B B0-B3 = FOREGROUND 

;L E R L N E R L B4~B6 = BACGROUND 

•IDEUTDEU 0= BLACK 1 = BLUE 

•N EEE EE GREEN 3= CYAN 

jK N N N 4 = RED 5= MAGNETA 

• S 6 = BROWN 7= WHITE 

5 I a = GRAY 9= LIGHT BLUE 

5 T 10 « LIGHT GREEN 11= LIGHT 

5 Y CYAN 

. 12= LIGHT RED 13= LIGHT 

- MAGNETA 

5 14= YELLOW 15= WHITE 

. HIGH INTENSITY 

•MONOCHROME EXAMPLES: 

-0000 0000=NO DISPLAY BLACK/BLACK 

.0000 0001= UNDERLINE CHARACTER 

-0000 0111= NORMAL WHITE/BLACK 

-0111 0 1 1 1 = NO DISPLAY WHITE/WHITE 

-1111 1000= BLINK, REVERSE VIDEO,HIGH 

- INTENSITY 
;COLOR CHARACTER EXAMPLE: 

•01 0 1 1 00 1 = Magneta background, 

• Character is Light blue 
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************************************************************* 
THIS MACRO WILL SET THE VIDEO MODE- PASS THE ARGUMENT AS 


FOLLOWS: 


AL= 0 
AL= 1 
AL= 
AL= 
AL= 
AL= 
AL= 


£ 

3 

4 

5 

6 


TEXT 40 X 
TEXT 40 X 
TEXT 60 X 
TEXT 60 X 
GRAPHICS, 
GRAPHICS, 
GRAPHICS, 


£5-B/W 

E5-C0L0R 

£5~B/W 

25-COLOR 

320 X 200-B/W 

320 X 200-COLOR 

640 X 200-B/W 


;THIS IS A BIOS CALL AND AS SUCH MAY NOT WORK WITH 
;ALL PC "COMPATIBLES". 

5 

;Function 00H 




0VDMODE 

MACRO 

MODE 




MOV 

MOV 

AH,F MODESET 
AL,MODE 

;MODE 

SET 


INT BIOS 

ENDM 

;BIOS 

CALL 


5******************************************************* 

;THIS MACRO ALLOWS YOU TO CHANGE THE CURSOR. 

5LOAD THE VALUE OF THE START SCAN LINE INTO CH 
;AND THE END SCAN LINE INTO CL. 

;VALID PARAMETERS ARE: 0-13 OR 0-7 FOR COLOR MONITOR 


5 Function 01H 


@CURCHG 


MACRO SLINE,ELINE 


MOV 

CH,SLINE 

5GET START LINE 

MOV 

CL,ELINE 

;GET END LINE 

MOV 

AH,F CURCHG 

!CHANGE CURSOR FUNCTION 

INT 

BIOS 

;BIOS CALL 

ENDM 




************************************************************ 
THIS MACRO WILL SET THE CURSOR POSITION 
BH = PAGE, DH= ROW, DL= COLUMN 
PAGENUM ROW COL 


;Function 

: 02H 


C-CURSET 

MACRO PAGENUM, 

ROW,COL 

MOV 

BH,PAGENUM 

;GET THE PAGE NUMBER 

MOV 

DH,ROW 

;GET ROW (0-24) 

MOV 

DL,COL 

;GET COL (0-79) 

MOV 

AH,F CURSET 

;FUNCTION CODE TO SET CURSOR 

INT 

ENDM 

BIOS 

;BIOS CALL 


********************************************************* 

THIS MACRO WILL FETCH THE CURSOR POSITION. ON RETURN 
THE ROW/COL COORDINATES WILL BE IN DX <DH=ROW,DL=COL) 


;Function: 03H 
C-CURRD MACRO 

MOV AH,F^CURRD ;G£T FUNCTION CODE TO READ 

;POSITION 

INT BIOS ;BIOS CAlL 

ENDM 
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************»*************************************** 
THIS MfiCRO WILL READ THE LIBHT PEN POSITION 
IF THE SYSTEM IS SO EQUIPPED. 

ON RETURN; fiH=0 PEN NOT TRIGGERED 


;OTHERWISE 

s HND DH=ROW, 

DL=COL 


CH=SCftN 

ROW (0-199) 


BX=PIXEL 

COLUMN (0-319 -LOW RES) 



(0-639- HIGH RES) 

;Function 

0AH 


©PENRD 

MACRO 



MOV AH,F PENRD 

;READ PEN POSITION 


INT BIOS 

;BIOS CALL 


ENDM 



’;THIS MACRO WILL SET THE ACTIVE VIDEO PAGE 

•Function 

05H 


©VDPGSET 

MACRO PAGENUM 


MOV 

AH,F^PGSET 

;PAGE SET FUNCTION 

MOV 

AL,PAGENUM 

-,PARAMETER= PAGE NUMBER 

INT 

BIOS 

;BIOS CALL 

ENDM 




THIS MACRO WILL SCROLL A CERTAIN NUMBER OF LINES IN A 
GIVEN DIRECTION, FOR A GIVEN BET OF CORORDINATES, WITH A 
SPECIFIED ATTRIBUTE BYTE. 

aN EXAMPLE WOULD BE TO PASS 06,00,18H,4FH,00,00,07 AS 
PARAMETERS TO THE MACRO. THIS WOULD SCROLL THE SCREEN 
UP <06), FOR ALL LINES IN WINDOW (00), FROM THE TOP LEFT 
CORNER (ROW=0, COLUMN= 0), TO THE LOWER RIGHT CORNER 
(ROW = IBh = 24, COL= 4FH = 79), WITH A NORMAL CHARACTER 
ATTRIBUTE (07). tHE EFFECT OF THESE PARAMETERS WOULD BE 
TO CLEAR THE SCREEN. 

THIS IS A BIOS CALL AND MAY NOT BE COMPATIBLE WITH ALL 
iPC CLONES. 


T 

;Function 

06H = 

Scroll uo 


5 

07H = 

Scro11 Down 


©SCROLL MACRO 

DIRECTION, LINES, 

LRROW,LRCOL,UlROW, UlCOL, ATTRIBU" 


MOV 

AH,DIRECTION 

;REQUEST SCROLL UP/DOWN 


MOV 

AL,LINES 

;NUMBER OF LINES TO SCROLL 
;0 = ALL LINES IN WINDOW 


MOV 

DH,LRROW 

5LOWER RIGHT ROW 


MOV 

DL,LRCOL 

slower RIGHT COLUMN 


MOV 

CH,ULROW 

;UPPER LEFT ROW 


MOV 

CL,ULCOL 

SUPPER LEFT COLUMN 


MOV 

BH,ATTRIBUTE 

5ATTRIBUTE BYTE 


INT 

ENDM 

BIOS 

sBIOS CALL 


*****.****************♦*******♦*♦******************** 

THIS MACRO WILL RETURN THE CHARACTER WHICH IS AT 
THE CURRENT CURSOR POSITION. 

BH= PAGE NUMBER 

ON RETURN: AL= CHARACTER, BL= ATTRIBUTE 


Function: OSH 
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C-CHftRRD MACRO PAGENUM 

MOV AH,F_CHARRD 
MOV BH,PAGENUM 
INT BIOS 
ENDM 

;THIS MACRO WILL SEND A CHARACTER IN AL TO THE VIDEO 
5DISPLAY. BH=PAGE CX= NUMBER OF CHARACTERS TO OUTPUT 
; AL= CHARACTER , BL= ATTRIBUTE BYTE 

;Function: 09H 

C-VDCHAR2 MACRO PAGENUM, CHARACTERS, ATTRIBUTE 

MOV BH,PAGENUM 
MOV BL,ATTRIBUTE 
MOV CX,CHARACTERS 
MOV AH,F VDCHAR2 
INT BIOS 
ENDM 

•**********************************************^t******* 

5 THIS MACRO WILL SEND THE CHARACTER IN AL TO THE 
;VIDEO DISPLAY. THE EXISTING VIDEO ATTRIBUTE IS USED 
; BH= PAGE NUMBER, CX= NUMBER OF CHARACTERS 
? 

;Function: 0AH 

©VDCHARl MACRO PAGENUM, CHARACTERS 

MOV BH,PAGENUM 
MOV CX,CHARACTERS 
MOV AH,F^VDCHARl 
INT BIOS 
ENDM 

• ****************************************************** 
;THIS MACRO WILL SET EITHER FOREGROUND OR BACKGROUND 
;COLORS. THE CHOICE OF COLOR FOR BACKGROUND IS PUT 
;INTO BL (0-15); AND TO SELECT ONE OF TWO COLOR 
;PALETTES FOR FOREGROUND, SET BL TO 0 = GR, RED, BRN 
; 1 = CY, MAGNETA, WHITE 

;BH= 0 = BACKGROUND 
;BH= 1 = FOREGROUND (PALETTE) 

;Function: 0BH 

C-COLORSET MACRO GROUND, COLOR 


MOV 

BH,GROUND 

;BACK OR FOREGROUND? 

MOV 

AH,F COLORSET 

;FUNCTION CALL NUMBER 

MOV 

BL,COLOR 

;GET COLOR OR PALETTE TYPE 

INT 

BIOS 


ENDM 




- *********************************^******************** 

;THIS MACRO WILL SET (TURN ON) A GRAPHICS PIXEL 
;GIVEN IT’S POSITION AND COLOR. 

;DX = ROW = 0 TO 199, CX = COL = 0 TO 319 (MED RES) 

; 0 TO 639 (HIGH RES) 

;See the video definitions at the beginnihc of the video 
;macros. 

;Use this function to reset a pixel by soecifyinp a foreprouna 
;color the same as the background color. 
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Function: 0CH 


©SET 


MACRO 

ROW, COL,COLOR 

MOV 

AH,F SET 

MOV 

DX,ROW 

MOV 

CX,COL 

MOV 

AL, COLOR 

INT 

BIOS 

ENDM 



;SET DOT FUNCTION CODE 


****************************************************** 

THIS MACRO WILL TEST A DOT POSITION. THE COLOR IS RETURNED 
IN AL. DX=RQW, CX= COL. 


;Function: 0DH 

©POINT MACRO ROW, COL 

MOV DX,ROW 
MOV CX,COL 
MOV AH,F_POINT 
INT BIOS 
ENDM 

;****************************************************** 
5 THIS MACRO WILL OUTPUT A CHARACTER IN AL TO THE VIDEO 

5 DISPLAY. BH= PAGE NUMBER, BL= COLOR (GRAPHICS MODE), 

; AL=CHARACTER (MUST BE IN AL PRIOR TO 

5 INVOKING THE MACRO). 

5 

;Function: ©EH 

©VDCHAR3 MACRO PAGENUM, COLOR 

MOV BH,PAGENUM 
MOV BL,COLOR 

MOV AH,F VDCHAR3 :BIOS FUNCTION NUMBER 

INT BIOS~ 

ENDM 

;****************************************************** 

;THIS MACRO WILL RETURN THE CURRENT VIDEO MlODE IN Al. 

;ON RETURN AL= MODE, BH= ACTIVE PAGE, AH= ACTIVE COLUMN 


;Function: ©FH 
©VDMODERD MACRO 

MOV AH,F^MODERD ;READ FUNCTION MODE 

INT BIDS 

ENDM 

;****************************************************** 

;These macros orovide an interface to the BIOS v'outines 
;which can be used to access the printer. 

;BIOS INTERRUPT TYPE: 17H 

;*****************^;ip*********************************** 
;The first macro will return the printer’s status in AH. 
;b7 5 = 1 = Printer busy 
~ 1 =: Acknowledde 
;b5 = 1 * Paper out 
-b4 = 1 = Printer selected 
;b3 « 1 = I/O Error 
;b2 = X = Unused 
;bl = X = unused 
•b© = 1 = Time Out 
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Listing 6-1 continued 

• See page of the IBM Techriicai Reference manual for 

;a description of the routines used for printer BIDS I/O. 


©PRINTER STATUS MACRO 

MOV AH,F^PRINTER^STATUS ;Get function coce 

INT 17H sGo throuch BIOS 

ENDM 

• *****************************************************•»(•***** 
;This macro will send a character in AL to the printer. 

;After executing the BIOS routine, the status will be returnee 
;in AH. 

©PRINTER^OUT^B MACRO 

MOV AH, F__PRINTER OUT„B 5 BIOS function code 

INT 17H 

ENDM 

;*********************************************************** 
;This macro function will reset and initialize the printer 
;port. 

©PRINTER^INIT MACRO 

MOV AH,F^PRINTER INIT 

INT 17H 

ENDM 

;*********************************************************** 
;BIOS INTERRUPT TYPE: 14H 
; RS~£3£C cornmuni cat i on f unct i ons 
- *********************************************************** 

;These macros will handle serial I/O through BIOS calls. 

•See page A22 of the IBM Techniacl reference manual for a 
;detailed expalnation of the bit assignments used in the 
;RS_INIT macro. 


INIT 

MACRO CONFIG,PORT 


MOV 

AL,CONFIG 

;Get the confiouration 

MOV 

DX,PORT 

5 I OR 2 

MOV 

AH,F RS232 INIT 


I NT 
ENDM 

14H 

;BIOS call 


*********************************************************** 

;This macro will get a character from the serial port. 

;No check in the macro is made to see if there is one ready. 

;your program should do this before invoking this macro. 

;use the RS_STATUS to see if there is a character ready. 

5 AH will be zero on return, if a character was recieved 

;without error, and is in AL. If AH <> 0 then AH = the status of the port. 


©RS^INPUT 

MOV 

MOV 

INT 

ENDM 


MACRO PORT 
DX,PORT 
AH,F_RS INPUT 
14H 


5 Which port? 

5 Function code 
;BIOS call 


.««««««««.«.«««««.***************************«« 4 (.«««.«.)^«****** 

;This macro will send a character via the serial channel. 

;The character to be transmitted is in AL on invoking the macro. 

;If b7 of AH is set on return, an error occurred and b6-b0 = status. 


@RS SEND 

MOV 

MOV 

INT 

ENDM 


MACRO PORT 
DX,PORT 
AH,F^RS^OUT 
14H 


;Function code 


; *********************************************************** 
;This macro will read the serial port status. 
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;The status is 

ret urned 

in AX and is described 

;IBM technical 

reference 

manual 

on page A-23. 

©RS STATUS 

MACRO 

PORT 


MOV 

DX,PORT 



MOV 

AH,F RS 

STATUS 

;Function code 

I NT 

14H 



ENDM 





• *********************************************************** 

;The following macros are orovided as an aid in □rocrarnming- 
;They orovide many commonly used VIDEO functions. 
;****************************************************** 

? 

;This macro provides the NEW LINfc. function (CR,LF) combination. 
eCRLF MACRO 

MOV DL,0DH sCARRIAGE RETURN 

©CHARDSP 5DISPLAY CHARACTER MACRO 

MOV DL,0AH ;LI1ME FEED 

C-CHARDSP 

ENDM 

©NEWSLINE MACRO 

©CRLF 
ENDM 

;This macro provides a line feed and carriage return combination 
©LFCR MACRO 

MOV DL,0AH ;LINEFEED 

©CHARDSP 

MOV DL,0DH ;CARRIAG£ RETURN 

©CHARDSP 

ENDM 

;This macro does a carriaoe return only. 

©CR MACRO 

MOV DL,0DH 5DO CARRIAGE RETURN 

©CHARDSP 

ENDM 

;This macro does a line feed only 
©LF MACRO 

MOV DL,0AH ;D0 A LINE FEED ONi-Y 

©CHARDSP 

ENDM 
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Listing 6-2 
DOSEQU.EQU 


Filename: DOSEQU. EOU 
5 MSDOS and BIOS eauate file. 
;Last revised: 10-24-84 
5 

; (c) Gary P. Shade 


************************************************************** 
;THIS FILE ALSO CONTAINS MANY BIOS SYSTEM CALL FUNCTION 
;NUMBERS. IT SHOULD BE NOTED THAT UNLESS A "COMPATIBLE" 

:PC EMULATES THESE BIOS CALLS WHICH ARE PART OF THE BIOS ROM 
:IN THE IBM PC, PROGRAMS WRITTEN USING THESE CALLS MAY NOT BE 
: “COMPATIBLE" WITH OTHER COMPUTERS. 


************ BIOS EQUATES FOR INT 10H - VIDEO FUNCTIONS *** 


F^MODESET EQU 0 
F^CURCHG EQU 1 
F_^CURSET EQU 2 
F CURRD EQU 3 
F^PENRD EQU 4 
F PGSET EQU 5 
F_^DIRECUP EQU 6 
F DIRECDWN EQU 

F^CHARRD EQU 8 
F VDCHARl EQU 9 
F^VDCHAR2 EQU 0AH 
F COLORSET EQU 

F^SET EQU 0CH 
F POINT EQU 0DH 
F^VDCHARS EQU 0EH 
F MODERD EQU 0FH 


0BH 


;SETS VIDEO MODE 
:CHANGES CURSOR 
:SET CURSOR POSITION 
;GETS CURSOR POSITION 
:READS LIGHT PEN IF INSTALLED 
:SETS ACTIVE VIDEO PAGE 
:SCROLLS THE SCREEN UP 
:SCROLLS THE SCREEN DOWN 
;GET CHAR AT CURSOR 
;DISPLAY CHAR WITH ATTRIBUTE 
;DISPLAY CHARACTER W/0 ATTRIBUTE 
:SET GRAPHICS COLOR 
;SET A GRAPHICS PIXEL 
;GET THE COLOR OF PIXEL 
;OUTPUT CHARACTER AT CURSOR 
:READ ACTIVE VIDEO MODE 


********************************************************** 


:BIOS INT 14H 

function 

codes. 

Used in serial I/O 

F 

RS232 INIT 

EQU 

00H 

5 Initialize serial port 

F 

RS INPUT 

EQU 

01H 

;Get character from port 

F 

RS OUT 

EQU 

02H 

:Transmit function 

F 

RS STATUS 

EQU 

03H 

;Read the port status 


;********************************************************* 

;BIOS INT 17H function codes. Used in printer I/O. 

F^PRINTER^INIT EQU 00H ;Initialize printer port 

F PRINTER^OUT^B EQU 01H :Send a character to the printer 

f“”pRINTER status EQU 02H :Fetch status function 


********************************************************** 
;DOS FUNCTIONS NEXT,,,,,,, INT 21H *********************** 
********************************************************** 
F_,TERMINATE EQU 00 :TERMINATE USER PROGRAM 

F^WAITKEY EQU 01H ;WAIT FOR KEY INPUT 
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F_,CHftRDSP EQU 02H 5 DISPLAY CHAR IN DL 

F WAITAUX EQU 03H ;WAIT FOR CHAR FROM AUX DEVICE 

fIaUXOUT EQU 04H ;LIKE VALSPEAK OK? GET CHAR. FROM AUX DEVICE 

F^PRINTER^OUT EQU 05H ;CHAR TO PRINTER 

F^^CON^IO EQU 06H ;KBD/DISPLAY ROUTINE 

F_.CON INPUT EQU 07H sKBD INPUT 

F__CON^INPUTS EQU 08H ;KBD INPUT 

F VDLINE EQU 09H ;DISPLAY LINE TO DELIMITER 

;ON VIDEO DISPLAY 

F KBDLINE EQU 0AH ;ACCEPT A LINE OF INPUT FROM THE 

;KEYBOARD 

F PEEK BUFFER EQU 0BH ;SEE IF CHAR IN TYPE AHEAD BUFFER 

F KBD_FLUSH EQU 0CH ;FLUSH TYPE AHEAD BUFFER. 

F^DISK^RESET EQU 0DH ;FLUSH FILE BUFFERS 

F_SELECT^DISK EQU 0EH 5 LOB ON NEW DRIVE 

F OPEN EQU 0FH ;OPEN FCB 

ENCLOSE EQU 10H ;CLOSE FCB 

F DIR„SEARCH EQU IIH ;SEARCH DIRECTORY 

F_,SEARCH_NEXT EQU 1£H ; SEARCH FOR NEXT ENRTY 

F__DELETE^FILES EQU 13H ^DELETE FILE<S) 

F__READ_SRECORD EQU 14H 5 READ SEQUENTIAL RECORD 

F_WRITE_SRECORD EQU 15H 5 WRITE SEQUENTIAL RECORD 

F__CREATE^FILE EQU 16H ;CREATE/OR OPEN FILE 

F^RENAME^FILE EQU 17H ;RENAME AN EXISTING FILE 

F^CURRENT_DISK EQU 19H ;READ THE CURRENT DRIVE CODE 

F^SET^DTA EQU lAH 5 SETS THE DTA TO SPECIFIED ADDRESS 

F^GET^FAT EQU IBH 5 GET THE FILE ALLOCATION TABLE 

F_READ_RRECORD EQU 21H ;READ A RANDOM RECORD 

F^WRITE_RRECORD EQU 22H ;WRITE A RANDOM RECORD 

F^GET^FILE^SIZE EQU 23H 5 RETURNS THE NUMBER OF RECORDS IN A FILE 

F^SET_REL_RECORD EQU 24H ;SETS RELATIVE RECORD. 

F^SET_INT^VECTOR EQU 25H :SET’S A TYPE’S VECTOR 

F^BLOCK^RREAD EQU 27H ;RANDOM BLOCK READ 

F BLOCK^RWRITE EQU 28H ;RANDOM BLOCK WRITE 

F^PARSE^STRING EQU 29H ;PARSE STRING FOR FILENAME 

F^GET^DATE EQU 2AH ;READ THE CURRENT DATE 

F^SET^DATE EQU 2BH ;SET THE DATE 

F GET^TIME EQU 2CH ;GET THE TIME 

F_SET_.TIME EQU 2DH ;SET THE TIME 

F^VERIFY^WRITE EQU 2 EH ;SET THE VERIFY FLAG (ON/OFF) 

F^GET^DTA EQU 2FH ;FETCH THE DTA 

F^GET^VFERSION EQU 30H ;GET MAJOR/MINOR REV LEVEL 

F^TERMINATE_^RESIDENT EQU 31H 5 TERMINATE USER PROGRAM BUT 

;KEEP PROGRAM RESIDENT 

F^SET^C^CHECK EQU 33H ;SET/RESET CNTL C CHECKING 

F READ__VECTOR EQU 35H ; READ INTERRUPT VECTOR 

F GET^FREE^SPACE EQU 36H ;RETURNS THE FREE SPACE OF A DISK 

F_.MK^DIR EQU 39H ;CREATE A DIRECTORY 

F^RM^DIR EQU 3AH 5 REMOVE A DIRECTORY 

F CH_DIR EQU 3BH ;CHANGE THE CURRENT DIRECTORY 

fIcREATE^FILE^S EQU 3CH ;CREATE A FILE (VER. 2.0) 

F OPEN^FILE^S EQU 3DH ;OPEN A FILE (VERSION 2.0) 

F__CL0SE_FILE^2 EQU 3EH 5 CLOSE A FILE (VERSION 2.0) 

F_READ_FILE^2 EQU 3FH 5 READ A NUMBER OF CHARACTERS 

;FROM A FILE. 

F__.WRITE^FILE__2 EQU 40H ;WRITE A NUMBER OF BYTES TO 

sA FILE 

F__DELETE_FILE_2 EQU 41H ^DELETE THE SPECIFIED FILE 

F^MOVE POINTER EQU 42H 5 MOVE THE FILE POINTER 

F CHANGE__ATTRIBUTES EQU 43H ;CHANGE A FILE’S ATTRIBUTES 
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Listing 6-2 continued 

F_DUP__HftNDLE EQU 45H 
F^^DUP^HftNDLE^a EQU 46H 

F^CURRENT DIR EQU 47H 
F PLLOCATE^MEM EQU 48H 
F^DEftLLOCATE^MEM EQU 49H 
F^NEW^BLOCK^SIZE EQU 4PH 
F__LOAD_EXECUTE EQU 4BH 
F^EXIT EQU 4CH 
F^GET^RET^CODE EQU 4DH 

F^FIND^FILE EQU 4EH 
F__FIND_^NEXT^FILE EQU 4FH 
F READ^VERIFY^FLPG EQU 54H 
fIrENPME^FILEE EQU 56H 
F GET SET DT EQU 57H 


;DUPLICATE ft FILE’S HftNDLE 
;POINT EXISTING HftNDLE TO 
5 NEW FILE 

;GET THE CURRENT DIRECTORY PftTH 
5 ftLLOCftTE MEMORY TO ft PROGRftM 
:DEftLLOCftTE (FREE) MEMORY 
5 GROW OR SHRINK BLOCK SIZE 
;LOftD ftND/OR EXECUTE ft PROGRftM 
sTERMINftTE PROCESS 
5 GET THE RETURN CODE FROM 
;FUNCTION F^EXIT (4CH) 

;FIND FIRST FILE SPECIFIED 
5 FIND THE NEXT FILE ftS SPECIFIED 
;REftD THE VERIFY FLftG 
5 RENftME ft FILE OR PftTHNftME 
5 GET OR SET THE DTft 
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Listing 6-3 
KEYDSP 


PfiGE 60,132 

TITLE EXAMPLE KEYBOARD AMD VIDEO DISPLAY PROGRAM- 
.XLIST 

include B:D0SEQU.EQU 
.LIST 

IFl 

INCLUDE B:MACFLE.MAC 
END IF 

•DISPLAY A LINE, GET KEYBOARD CHOICE. 

;DISPLAY 4 LINES, GET KEYBOARD INPUT. 

sDISPLAY PROMPT-WAIT FOR INPUT-DO THE FIRST PROCESS AGAIN 
;USE CONTROL-C TO RETURN TO MSDOS 
? 

; ***************************♦*******•)<•***•}<•***•«•********•«••«•*•«•** 
MY^STACK SEGMENT PARA STACK ’STACK’ 

DW 100 DUP(?) 

TOP STACK EQU ^ 

MY^TACK ENDS 

;************************************************#**+*-«<-**-«-* 


MY .DATA 

SEGMENT PARA ’DATA’ 


KBD BUFFER 

LABEL BYTE 


MAX CHARS 


DB 30 


CHARS. TYPED 

DB ? 

;AC““UAL NUMBER TY^ED 

K BUFF 


DB 30 DUP(’ ’ ) 

:INIT TO ZERO 46 BYTES 

DELIMITER 


DB . 

;END OF BUFFER 

MESSAGE1 

DB 

’Enter what you 

like anc I will disoiay it. 


DB 

0AH,0DH,’$’ 


MESSAGES 

DB 

’Hit any key t o 

continue’,0AH,0DH,’$’ 

MESSAGES 

DB 

’This is messace 

numbev' 3’ , 0AH, 0Dh, ’ $’ 

MESSA6E4 

DB 

’This is rnessaoe 

number 4’,0AH,0DH,’$’ 

MESSAGES 

DB 

’ENTER UP TO 30 

CHARS. MAX. ’ ,0AH,0DH,’$’ 

MY^DATA 

ENDS 



•********************************************************* 

MY^CODE 

SEGMENT PARA ’CODE’ 


START 

PROC 

FAR 



ASSUME CS:MY CODE, 

DS:MY DATA,SS2 MY STACK,ES:M' 


PUSH 

DS 

.-SAVE RETURN 


XOR 

AX, AX 

;AND 0!-FSET 


PUSH 

AX 


BEGIN: 

MOV 

AX,MY CODE 

:INITIALIZE REGISTERS 


MOV 

AX,MY DATA 
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Listing 6-3 continued 

MOV ES, fix 
MOV DS,fiX 

* ***** DEMONSTRfiTE MfiCRO USfiGE. INSERT MACROS IM MfilM LIM-i UUUE 
;***** ft LITTLE LIKE fi HIGH LEVEL LfiNGUfibE. 


BEGINS: 


START 


@VDLIME MESSAGE! 
eVDLINE MESSAGES 
©WAITKEY 


sDISPl-AY “!“H£ first MESSAGE 
sETC. 

;l^AIT FOR KEYBOARD INPUT 


@CRLF ;Go to the next line 

C-VDLINE MESSAGES ;DISPLAY MESS 3-5 

C-VDLINE MESSAGE4 ;DISPLAY MESS 4 

©VDLINE MESSAGES ;MESSAGE 5 

©KBDLINE KBD BUi='F£R ;GET LINE FROM 


LEA BX,CHARS_TYPED 


;Use as an 
5 entered. 


offset 


KBD 

t o iast 


char. 


MOV K^BUFFCBX3, 
@VDLINE K_BU-F 
C-CRLF 

CALL CLRBUF 
JMP BEGINS 
ENDP 


;Terminate the character*' string. 
;DisQlay the string. 

;co to the next video line. 

;Clear the kevboa*rd buffer 
:D0 IT ALL AGAIN 


;************************************************************** 

;Clear the keyboard buffer. Intitialize to soaces. 
****************************************************************** 
CLR BUFFER PROC NEAR 


CLRBUF: 

MOV 

CX, 30 


MOV 

DI,0000 

CLR^LOOP: 

MOV 

K BUFFCDI3,S0H 


INC 

DI 


LOOP 

RET 

CLR_LOOP 

CLR_BUFFER 

ENDP 

MY_„CODE 

ENDS 



END 

START 


;CLEAR THE KEYBOARD BUFFER 
;SET DI TO ZERO OFFSET 
'5BLANK BUFFER POSITION 
:INCREMENT POINTER 
;LOOP FOR 30 TIMES 
;RETURN TO CALLER 
:END OF PROCEDURE 
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Listing 7-1 
NUMBERSY.ASM 


PAGE 60,132 

TITLE PROGRAM USING MACRO CALLS 
SUBTTL Numbering Systems 

.XLIST 

INCLUDE B:DOSEQU.EQU 
.LIST 

IFl 

INCLUDE BsMACFLE.MAC 
END IF 


************************************************************* 

Created 0a-“06~84 

By: Gary A. Shade 

<c) 1984 All Rights Reserved 

Last Updated: 09-23-84 

This program will convet^t numbers entered from the keyboard 

to other number bases. MACFLE.ASM file, 

and the DOS equate file are used in this file. 

The numbers entered may either be decimal, binary, or hexadecimal 
numbers. You must enter all digits for each number base to be converted. 
Failure to do so will result in erroneous results. 

For example: to convert a decimal number, you must enter 

5 digits between 0 and 9. The maximum value you can 

enter is 65536, and the minimum is 0. Negative numbers are not 

allowed. 

HEXADECIMAL numbers must be a number (0-9) or a letter (A-F) only. 

The hex entry must be 4 digits in length. Example: F07F. 

BINARY values must be 16 digits in length and consist of either a 
’1’ or a ’0’ (Enter only 1 or 0). No spaces between bits. 

16 bit Example: 0100011100110101 
8 bit Example: 0000000010010101 

(You must enter 8 leading for 8 bit binary numbers) 

All keyboard entries must terminate with a carriage return. 


MY^DATA SEGMENT PARA ’DATA’ 

KBD^BUFFER LABEL BYTE 

MAX CHARS DB 32 

CHARS TYPED DB ? 


; MAXIMUM ALLOWED 
;NUMBER OF CHARS TYPED 
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Listing 7-1 continued 


K^BUFF 

DB 

3£ DUP<’ ’) 5KEYBOARD BUFFER 

DELIMITER 

DB 

;STRING TERMINATOR 

MESSAGE^© 

DB 

’1) Convert decimal to binary &• hex. ’ 


DB 


MESSAGE_01 

DB 

’£) Convert binary to decimal & hex. ’ 


DB 


MESSAGE^0£ 

DB 

’3) Convert hexadecimal to binary and decimal. ’ 


DB 


MESSAGE^1 

DB 

’Enter the decimal value you want to converts ’ 


DB 


MESSAGE^a 

DB 

’Enter the binary value you want to converts ’ 


DB 


MESSAGE'S 

DB 

’Enter the hexadecimal value you want to convert 


DB 


MESSAGE_4 

DB 

’Enter ’ 


DB 


MESSAGE'S 

DB 

’dioitss ’ 


DB 


MESSAGE'S 

DB 

’Binary ’ 


DB 


MESSAGE^? 

DB 

’ Dec i rna 1 ’ 


DB 


MESSAGE^a 

DB 

’Hexadecimal ’ 


DB 


MESSAGE'S 

DB 

’Do another conversion? (Y/N) s ’ 


DB 

’$’ 

HEXADECIMAL 

DW 

£ DUP (?) 


DB 


BINARY 

DW 


BINARY^ASCII 

DB 

16 DUP(£0H) 


DB 

’$’ 

DECIMAL 

DB 

5 DUP(?) 


DB 


DECIMAL POWERS 

DW 

10000,1000,100,10,1 

HEXADECIMAL POWERS DW 

4096,£56,16, 1 

MY^DATA 

ENDS 


:*************** DEFINE 

STACK AREA ******************** 

MY STACK 

SEGMENT 

PARA STACK ’STACK’ 

DW 

100 DUP(?) 

TOP OF STACK 

EQU 

$ 

MY STACK 

ENDS 



;****************************************************** 


;*********** MAIN PROGRAM STARTS HERE ***************** 

;Corivert a base 16 (hex), or a base £ (binary), or a 
•base 10 (decimal) number to the other number bases. 

5 There are four routines which will convert value from one base 
;to another. 

;BINA RY_HE X ADECIMAL 
;BINARY_DECIMAL 

•DECIMAL BINARY 

;HEX_BIN_DEC 

5 

;****************************************************** 
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;Program specific equates- 
ONE EQU 31H 

FOUR EQU 34H 

FIVE EQU 35H 

SIX EQU 36H 

SPPCE EQU 20H 

;****************************************************** 

;fl macro definition which is used to disolay multi ole rnessages- 
; It is used here in this program and is not part of the l^PC 
;file on disk. 


@DISP^PR0MPTS MACRO MESSl,MESSE,MESS3,NUMBER, NUMBER^; 

ifiVDLINE MESSl ;DISPLAY PROMPT 

C-LFCR ;CARRIAGE RETURN LINEFED 

@VDLINE MESS2 
MOV DL,NUMBER 

C-CHARDSP 

MOV DL,NUMBER £ 

eCHARDSP 
MOV DL,£0H 

C-CHARDSP 
©VDLINE MESS3 
C-LFCR 

©LFCR ;CR, LF 

ENDM 


;DISPLAY MAX DIGIT MESSAGE 
5MAXIMUM CHARACTERS TO 
;DISPLAY IN DL 
;DISPLAY £ND NUMBER I~ ANY. 

-, SPACE CHARACTER 

-,DISPLAY MESSAGE 


***************************************************************** 
Start of code segment 


MY CODE SEGMENT 

PARA ’CODE’ 


START PROC 

FAR 


ASSUME 

CS:MY^CODE,DS:MY^DATA,SS:MY^STACK,ES:MY^DATA 

INIT; 

PUSH 

DX 

;SAVE DOS RETURN 

XOR 

AX, AX 

;SAVE AN OFFSET OF ZERO 

PUSH 

AX 


MOV 

AX,MY_.DATA 

5 INITIALIZE DS AND ES 

MOV 

DS, AX 


MOV 

ES, AX 


START HERE: 

MOV 

CX,£4 5CLEAR 

SCREEN USING CARRIAGE RETURNS 

START HEREl: 

C-LFCR 

:CARRIAGE RETURN LINE FEED ROUTINE 

LOOP 

START^HEREl 

;DO UNTIL CX= 0 

MENU: 

eVDLINE 

MESSAGE^© 

5DISPLAY MAIN MENU 

@LFCR 


;GO TO NEXT LINE. 

©VDLINE 

MESSAGE_01 

;NEXT MESSAGE 

©LFCR 

C-VDLINE 

MESSAGE_,0£ 

;LAST LINE OF MENU. 

C-LFCR 


5 

RESPONSE: 

©WAITKEY ;WHICH 

FUNCTION IS DESIRED? 

PUSH 

AX 

;SAVE AX AND DO LF-CR 

©LFCR 


;NEXT LINE 

POP 

AX 

5 RESTORE VALUE 

AND 

AL,0FH 

;MASK BYTE 
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Listing 7-1 continued 
DEC AL 

J2 DEC^BIN^HEXl 

DEC AL 

JZ BIN^DEC^HEXl 

DEC AL 

JNE START^HERE 

CALL GET^HEX 

D0NE_IT_^£: 

CALL FLUSH^BUFFERS 
CALL ANOTHER^ONE 

JC MENUl 

RET 

MENUl: 

JMP MENU 


BIN DEC^HEXl: 

CALL BIN^DEC^HEX 
JMP DONE_IT_£ 

DEC BIN HEXl: 

CALL DEC^BIN HEX 

JMP DONE^IT £ 

START ENDP 


;CONVERT DEC TO OTHER? 

;IF SO THEN GO CONVERT 
;IF THE NUMBER WAS £ THEN 
;GO THE OTHER WAY 
;IF NOT 3 THEN RESTART 

•OTHERWISE, DO A HEX CONVERSION 

;ZERO ALL BUFFERS 

;DO ANOTHER CONVERSIO? 
sIF CARRY SET THEN YES 
;ELSE END 

:THIS IS AN ISLAND JUMP 
;TO REACH THE MENU ROUTINE. 

;DO BINARY CONVERSIONS 

;COMMON RETURN POINT 

;DECIMAL CONVERSIONS 
;ALL DONE 

;END OF MAIN PROCEDURE 


*************************************************************** 
This routine will get Hexadecimal digits from the keyboard and 
convert them to decimal and binary. 

Reauires procedures: HEX BIN DEC, BINARY^DECIMAl, AND 

DISP ASCII^BINARY 


;*************************************************************** 


NEAR 

HEX^BIN^DEC -, 

DISP ASCII BINARY 


GET^HEX PROC 
CALL 
DSP ASC^BIN: 

CALL 
@LFCR 

CALL BINARY^DECIMAL 

eVDLINE DECIMAL 
MOV DL,£0H 

C-CHARDSP 

C-VDLINE MESSAGE,.? 

RET 

GET HEX ENDP 


GET HEX DIGITS 

;DISPLAY ASCII STRING 

;CONVERT TO DECIMAL 
5 DISPALAY STRING 
•SPACE 

•DISPLAY CHAR IN DL 
DECIMAL’ 

;RETURN TO CALLER 
;END OF PROCEDURE 


;****** Convert decimal to binary and hexadecimal. ************** 
;This is the entire routine to fetch the keyboard entry of a 
;decimal number <5 digits), and convert that number to binary, 

;ASCII-Binary, and ASCII-Hex, and to display the conversions 
;on the screen. The procedures which actually perform 
5 the conversions are called from this section of code. 

5 

DEC BIN,.HEX PROC NEAR 

MOV MAX,.CHARS, 6 ; ACCEPT 5 CHARACTERS 

C-DISP,.PROMPTS MESSAGE^l, MESSAGE.,4, MESSAGE'S, FIVE, SPACE 
0KBDLINE KBD,.BUFFER ;GET THE STRING FROM KBD. 

©LFCR ;DO NEW LINE 
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LEA SI,K BUFF 

LEft DI,DECIMAL 

MOV CX,05H 

CLD 

REP MOVSB 

D_B_H 2: 

CALL DECIMAL^BINARY 

CALL BINARY^HEXADECIMAL 

D_B_H 3: 

C-VDLINE HEXADECIMAL 
MOV DL,20H 

C-CHARDSP 

eVDLINE MESSAGE^a 
eLFCR 

CALL DISP ASCII BINARY 

RET 

DEC BIN HEX ENDP 


;MOVE INPUT FROM KEYBD BUFFER 
;TO DECIMAL STRING BUFFER 
?MOVE 5 CHARACTERS 
;CLEAR DIRECTION FLAG 
5 AUTO INCREMENT POINTERS 
;MOVE THE STRING 

;CONVERT DECIMAL TO BINARY 
;CONVERT BINARY TO HEX 

;DISPLAY HEXADECIMAL 
;DISPLAY A SPACE 
;DISPLAY CHAR. IN DL. 

;DISPLAY ’HEX’ 

;CARRIAGE RETURN LINEFEED 
;DISPLAY ASCII BINARY STRING 
;ALL DONE RETURN TO CALLER 
;END OF PROCEDURE 


;***** Binary to decimal and hexadecimal routine. ****************** 
;Convert an ASCII-binary entry from the keyboard into ASCII-Decimal, 

5 and ASCII-HEX for display. 

BIN^DEC^HEX PROC NEAR 

MOV MAX CHARS,17 ;MUST ENTER 16 CHARACTERS 

eDISP PROMPTS MESSAGE 2,MESSAGE 4,MESSAGE 5,ONE,SIX 


@KBDLINE KBD^BUFFER 

0LFCR 

LEA 

SI,K BUFF 

LEA 

DI,BINARY ASCII 

MOV 

CX, 16 

CLD 


REP 

MOVSB 

CALL ASCII^BIN^CONV 

CALL 

BINARY HEXADECIMAL 

0VDLINE 

HEXADECIMAL 

MOV 

DL,20H 

eCHARDSP 

©VDLINE 

@LFCR 

MESSAGE __8 

CALL 

BINARY DECIMAL 

©VDLINE 

DECIMAL 

MOV 

DL,20H 

©CHARDSO 

©VDLINE 

@LFCR 

RET 

MESSAGE^? 


BIN DEC HEX ENDP 


GET INPUT 

GO DOWN TO NEXT LINE 
MOVE STRING TO ASCII BUFFER 

DO IT 16 TIMES 
CLEAR DF, AUTO INCREMENT 
MOVE BYTE STRING 
CONVERT ASCII BINARY TO 
BINARY 

CONVERT TO ASCII HEX 
DISPLAY HEX STRING 
SPACE CHARACTER 
DISPLAY CHAR IN DL 
’HEXADECIMAL’ 

NEW LINE 

CONVERT BINARY TO DEC. STRING 

DISPLAY STRING 

ASCII SPACE 

DISPLAY IT 

l’DECIMAL’ 

NEWLINE 


************** Convert hexadecimal number to decimal and binary. 

1) A 4 digit hexadecimal number is entered from the keyboard. 

2) Because the number is in ASCII, set the high order nibble of 
each number to zero, and multiply by the base 16 power that 

the number occupies, and accumulate the products of the 4 digits. 
The number will have been converted to binary. 

3) To display the number, test each bit position (shift into carry). 
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Listing 7-1 continued 

if it is a 
If the bit 
space. 

4) The number which 


zero then display a 30H (ftSCII zero) followed by a space, 
value is M’, then display 31H (^^SCII one) followed by a 


A) 

B) 


C) 


D) 


is in binary format, can then converted to 
decimal as follows: 

Divide the binary number by the highest decimal digit’s power. 
Use the Logical ’OR’ function to convert the BCD (0-9) value 
obtained from the division, to an ASCII digit. Store the 
result- 

Repeat the operation for the remaining powers of ten (1000, 100, 

10, and 1). 

Display the decimal string. 


HEX^BIN^DEC 

MOV 

@DISP 


©KBDLINE 
@LFCR 
LEA 
LEA 
MOV 
CLD 
REP 
XOR 
MOV 
XOR 
MOV 


PROC NEAR 
MAX^CHARS,5 

PROMPTS MESSAGE^3, MESSAGE^, MESSAGE„5, FOUR, SPACE 


KBD BUFFER 


MULT HEX: 

MOV 

CMP 

JL 

SUB 

ASC^NUMERAL: 

AND 

XOR 

MUL 

ADD 

INC 

INC 

INC 

LOOP 

RET 

HEX_BIN_DEC 
;zeros and then 


ASCII 


BIN^CONV 

XOR 

MOV 

XOR 

MOV 


NEXT^BYTE: 

MOV 

AND 

JZ 

STC 


SI,K^BUFF 

DI,HEXADECIMAL 

CX,4 

MOVSB 
BX,BX 
BINARY,BX 
SI,SI 
CX,4 


POINT TO KEYBOARD BUFFER 
DO A LINEFEED, CARRIAGE RET. 
GET INPUT 
AND MOVE IT 

;CLEAR DF, AUTO INCREMENT 
;M0VE STRING TO BUFFER 
;CLEAR BASE REGISTER 
;CLEAR RAM ACCUMULATOR 
;POINT TO 1ST ENTRY 
;L00P FOR 4 DIGITS 


AL,BYTE PTR HEXADECIMALCBX3 


AL,41H 

ASC^NUMERAL 

AL,7 


AL,0FH 
AH, AH 

HEX ADECI MAL^^POWERS CS13 

BINARY,AX 

SI 

SI 

BX 

MULT^HEX 

ENDP 

the byte value. 


;GET VALUE 
;IF >= 41H THEN IT IS 
5AN ASCII A-F 

;IF NOT, THEN IT’S A NUMBER 
;OTHERWISE SUB 7 ADJUST FOR 
5ASCII 


NIBBLE 

(UNSIGNED) 


PROC 
AX, AX 
BINARY,AX 
SI,SI 
CX, 16 


NEAR 


;MASK HIGH ORDER NIBBLE 
ZERO HIGH ORDER 
MULTIPLY VALUES 
IGNORE HIGH ORDER RESULT 
POINT TO NEXT POWER 
(WORD VALUE) 

POINT TO NEXT HEX DIGIT 
MULTIPLY ALL POSITIONS 
OTHERWISE QUIT. 


;ZERO RAM LOCATION BINARY. 

;CLEAR INDEX REGISTER 
;NUMBER OF ITERATIONS. 


AL,BINARY^ASCIICSI3 
AL,0FH 
CLEAR CARRY 


;WORK ASCII MSB TO LSB 
;MASK HIGH ORDER NIBBLE 
;IF ZERO THEN CLEAR THE CARRY 
;OTHERWISE SET THE CARRY 
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EXEC^ 

LOOP: 




RCL 

BINARY, 1 

:ROTATE CARRY BIT LSB TO MSB. 
;LOCATION ’RAM' 


INC 

SI 

;INCREMENT POINTER 


LOOP 

NEXT_„BYTE 

;DO ALL 16 BITS 


RET 


RETURN WHEN ALL DIGITS DONE 

CLEAR 

CARRY: 

CLC 


;CLEAR FLAG 


JMP 

EXEC LOOP 

;CONTINUE TILL DONE 

ASCII 

BIN CONV 

ENDP 



.******»***********»*****•«.**************♦#***********************■»** 


9 ” " .. 

;This conversion routine will convert a 

5 digit decimal string * 

:at RAM location ’DECIMAL’ to a binary word. 

* 

:The converted 

binary word will be stored at RAM 

location ’BINARY’.* 

.******************************************************************* 

DECIMAL BINARY 

PROC NEAR 



XOR 

SI,SI 

:ZERO SI 

REGISTER 

MOV 

BINARY,SI 

;2ERO RAM 

LOCATION 

XOR 

DI,DI 

;POINT TO 

TABLE 

MOV 

CX,05H 

;DO IT FOR 5 DIGITS 

CONV BIN: 




MOV 

AL,DECIMALCSII 

•,GET 1ST 

DIGIT 

AND 

AX,000FH 

:MASK TO 

BCD 

MUL 

DECIMAL POWERSCDII 

;MULTI PLY 

BY POWER 

ADD 

BINARY,AX 

;ADD TO ACCUMULATOR 

INC 

SI 

;POINT TO 

NEXT DECIMAL DIGIT 

INC 

DI 

;POINT TO 

NEXT POWER 

INC 

DI 



LOOP 

CONV^BIN 

;LOOP FOR 

ALL DIGITS 

RET 


;ALL DONE 


DECIMAL BINARY 

ENDP 




;THIS PROCEDURE 

WILL CONVERT THE BINARY 

VALUE 

* 


sIN RAM LOCATION ’BINARY’ TO A 5 DIGIT DECIMAL STRING. * 

•THE ASCII DECIMAL STRING WILL BE STORED AT RAM LOCATION ’DECIMAL’. * 
******************************************************************** 

;CONVERT THE BINARY VALUE TO ASCII BINARY FOR 
•DISPLAY. 

DISP ASCII.BINARY PROC NEAR 



MOV 

AX, BINARY 

;GET VALUE TO DISPLAY 


MOV 

DI, 16 

;POINT TO LAST LOCATION 


MOV 

CX,DI 

;NUMBER OF BITS TO ROTATE 

FETCH, 

BIN BIT: 




ROR 

AX,1 :ROTATE 

LSB n IN CARRY 


JC 

A ONE BIT 

;IF CARRY = 1 THEN A ’1’ BIT 


MOV 

BINARY ASCIICDI~13,’0’ 

;STORE ASCII ZERO 


JMP 

LOOPING 

;DO NEXT LOCATION AND BIT 

A„.ONE. 

BIT: 




MOV 

BINARY,.ASCIICDI~13,’ 1’ 

;SAVE AN ASCII ONE 
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Listing 7-1 continued 

LOOPING: 

DEC DI ;POINT TO NEXT LOCATION 

LOOP FETCH^BIN^BIT ;DO FOR ALL 16 BITS 


DSP^ASC^BIN^VAL: 

MOV CX,16 

XOR DI,DI 

DSP^NEXT^CHAR: 

MOV DL,BINARY^ASCIICDn 

C-CHARDSP 

MOV DL,20H 

C-CHARDSP 

INC DI 

LOOP DSP^NEXT^CHAR 

©VDLINE MESSAGE^6 
C-LFCR 
RET 

DISP ASCII BINARY ENDP 


DISPLAY 16 BYTES 

5 ZERO POINTER 


;GET BYTE TO DISPLAY 
;DISPLAY IT. 

;DISPLAY SPACE 
;DISPLAY CHAR. IN DL 
;INCREMENT POINTER TO NEXT CHAR, 
;LOOP TILL ALL CHARS. DISPLAYED 
sDISPLAY WORD ’BINARY’ 

;DO CARRIAGE RETURN LINE FEED. 


*********** ASCII BINARY to BINARY CONVERSION ****************** 

This procedure will convert an 16 bit ASCI I-Binary number 
into it’s true binary equivalent. The 16 byte ASCII buffer, 

BINARY_ASCII (In RAM), is assummed to hold the ASCII value as entered 
from the keyboard. 

The routine will mask the ASCII character and test B® for a ’1’ or ’0’. 

For examole if the ASCII byte is 31H (for a binary 1), then 

the byte is anded with 0FH, leaving a result of 01H- Thus B® will 
contain either a ’1’ (if the value was 31H) or a ’®’ 

(if the value was 3®H). The carry is then set for a ’1’ or cleared 

for a ’®’, and the carry bit rotated into the LSB of the RAM 

location BINARY. This is done for all 16 bit positions of the word. 

Data entered must be for 16 bits and not less than 16 bits. If 
it is desired to enter a binary byte value, enter 8 leading 
******************************************************************** 


BINARY DECIMAL 

PRQC NEAR 


BiN_DEC: 

^ XOR 

SI,SI 

;CLEAR OTHER POINTER 

MOV 

CX,05H 

;5 BYTES IN LOOP 

DEC CLEAR: 

MOV 

DECIMALCSI3,’ ’ 

;STORE ASCII SPACE 

INC 

SI 

;NEXT LOCATION TO CLEAR 

LOOP 

DEC CLEAR 

;CLEAR 5 LOCATIONS 

MOV 

CX,04H 

;4 DIGITS IN LOOP 

XOR 

SI,SI 

;CLEAR POINTER 

MOV 

DI,SI 

;T0 POWER TABLE AND STORAGELDI3 

MOV 

AX, BINARY 

;GET BINARY VALUE TO CONVERT 

MAIN CONV: 

XOR 

DX,pX 5DX 

MUST BE CLEAR PRIOR TO 
;DIV INSTRUCTION 

DIV 

DECIMAL POWERSCS13 

5DIVIDE AX BY TABLE ENTRY 

OR 

AL,3®H 

;CONVERT TO ASCII 

MOV 

DECIMALCDI3,AL 

;STORE RESULT 

INC 

SI 

:INCREMENT TABLE POINTER 

INC 

SI 

;T0 NEXT DECIMAL VALUE 

INC 

DI 

;POINT TO NEXT STORAGE LOCATION 
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XCHG 

AX,DX 


5 GET REMAINDER FROM DX 


LOOP 

MAIN CONV 


5 DO ALL 4 MAJOR DIGITS 


OR 

AL,30H 


;STORE LAST DIGIT 


MOV 

DECIMALCDI3,AL 


;SAVE RESULT 


RET 



;DONE WITH CONVERSION 


BINftRY DECIMAL 

ENDP 




;**************************************************************** 

;This procedure 

will convert a 

binary value to a hexadecimal 

* 

5 stririg- 




* 

* 

sThe biriary value is stored in 

RAM at ’ 

BINARY’, and the 

* 

;ASCII-hex strina will be stored at ’HEXADECIMAL’ 

* 

.###************************************************************* 

BINARY HEXADECIMAL PROC 

NEAR 



CLR HEX: 





MOV 

CX,0£ 

;CLEAR 

FOUR BYTES 


XOR 

SI,SI 

;RESET 

POINTER 



CLR HEX_i: 



MOV 

HEXADECIMAL[:SI3,00H :STORE NULL BYTE 


INC 

SI 


;POINT TO NEXT BYTE 


LOOP 

CLR^HEX^l 


;CLEAR ALL LOCATIONS 

BIN 

«HEX_ 1 : 




;««« 

Convert 

the high order byte of the 

word, high order nibble 


followed 

by the low 

order nibble. 



XOR 

SI,SI 


;ZER0 INDEX REGISTER 


MOV 

AX,BINARY 

;GET VALUE TO CONVERT 


PUSH 

AX 


;SAVE IT ON STACK 


AND 

AH,0F0H 


;MASK LOW ORDER NIBBLE 


MOV 

CL,04H 


;NUMBER OF BITS TO SHIFT 


SHR 

AH, CL 


;SHIFT RIGHT 4 POSITIONS 


MOV 

BYTE PTR 

HEXfiDECIMflUCSI] 

,AH ;SAVE MASKED VALUE 


POP 

AX 


;RETRIVE BINARY VALUE 


PUSH 

AX 


;SAVE IT AGAIN 


AND 

AH,0FH 


;MASK HIGH ORDER NIBBLE 


INC 

SI 




MOV 

BYTE PTR 

HEXPDECIMftLCSII 

,AH ;SAVE MASKED VALUE 


Now do the same for 

the low order byte. 

BINJ 

HEX 2: 





POP 

AX 




PUSH 

AX 




AND 

AL,0F0H 


;MASK LOW ORDER NIBBLE 


MOV 

CL,04H 


;4 BITS TO SHIFT 


SHR 

AL, CL 


;SHIFT 4 BITS 


INC 

SI 


;POINT TO NEXT PLACE TO SAVE 





5 HEX CHARACTER 


MOV 

BYTE PTR 

HEXPDECIMPLCSI3 

,AL ;SAVE MASKED VALUE 


POP 

AX 


5 LAST NIBBLE TO DO 


AND 

AL,0FH 


;MASK H.O. NIBBLE 


INC 

SI 




MOV 

BYTE PTR 

HEXPDECIMPLCSI3 

,AL 


MOV 

CX,04 


;NUMBER OF HEX DIGITS 


XOR 

SI,SI 


;ZERO INDEX REGISTER 

NEXT 

ONE: 





MOV 

AL,BYTE PTR HEXADECIMALCSI3 :GET PSEUDO HEX BYTE 


CMP 

AL,0AH 


;IS IT > OR = 0AH? 


JGE 

ADD37 


;IF IT IS ADD 37 TO BYTE 
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OR 

BYTE PTR 

HEXADECIMALCSn,30H ;C0NVERT BYTE TO ASCII 

INC 

SI 


JMP 

NEXT DIGIT ;D0 TILL ALL 4 BYTES ARE 

;CONVERTED. 

ADD37: 

ADD 

AL,37H 

;ADD 37 TO VALUE TO 
;CONVERT IT TO ASCII 

MOV 

BYTE PTR 

HEXADECIMALCSI],AL ;SAVE IT 

INC 

SI 

:INCREMENT POINTER 

NEXT DIGIT: 

LOOP 

NEXT ONE 

:CONTINUE FOR ALL DIGITS 

RET 


BINARY HEXADECIMAL ENDP 


;*************************************************************** 
5 Procedure to flush the DECIMAL, HEXADECIMAL, BINARY and 
•,BINARY_ASCII buffers. 

**************************************************************** 


FLUSH^BUFFERS 

PROC NEAR 



BIN FLUSH: 

XOR 

AX, AX 

:ZERO AX 

MOV 

BINARY,AX 

;BINARY 

STORAGE IS CLEARED 

ASCII BIN FLUSH 
MOV 

"CX,16 

5CLEAR 

16 BYTES 

XOR 

SI,SI 


?ZERO POINTER 

A_B_F: 

MOV 

BINARY ASCII,AH 


;STORE A ZERO 

INC 

SI 


;INCREMENT POINTER 

LOOP 

ABF 


;CLEAR ALL BYTES 

HEX FLUSH: 

MOV 

HEXADECIMAL,AX 

;STORE 

ZERO WORD 

MOV 

HEXADECIMALC2D, 

AX 

;AND AGAIN 

DEC FLUSH: 

MOV 

CX,5 

;CLEAR 

5 DIGITS 

XOR 

SI,SI 


:ZERO POINTER 

D^F: 

MOV 

DECIMALCSn, AH 


;STORE A ZERO BYTE 

INC 

SI 


;INCREMENT POINTER 

LOOP 

D F 


5CLEAR ALL FIVE BYTES 

K BUFF FLUSH: 

MOV 

CX,3£: 


;CLEAR 3£ BYTES 

MOV 

AH,£0H 


;ASCI I SPACE 

XOR 

SI,SI 


5CLEAR POINTER 

K^B^F: 

MOV 

K__BUFF, AH 


:STORE BYTE 

INC 

SI 


;INCREMENT POINTER 

LOOP 

K B F 


•CLEAR ALL BYTES IN BUFFER 

RET 

FLUSH BUFFERS 

ENDP 




;*****#********************************************************** 

; Procedure to ask user if they want another conversion to take olace. 

5 On return, the carry flag will be set if the user wants to do another 
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;conversiori. If ’NO’, then the carry is reset. 
.**************************************************************** 


ANOTHER ONE 

PROC 

NEAR 


C-LFCR 



;NEW LINE FUNCTION 

GVDLINE 

MESSAGE 

9 

;DISPLAY PROMPT 

eWAITKEY 


;WAIT FOR INPUT 

CMP 

AL, ’Y’ 


;IS IT YES? 

JZ 

SET CF 


;IF IT IS THEN SET CARRY 

CMP 

«L, ’ y’ 



JZ 

SET CF 




;flNY OTHER KEY ENTRY WILL CHOSE THE PROGRAM TO END. 



GLFCR 

;NEW LINE FUNCTION 


CLC 

;CLEAR THE CARRY FLAG 


RET 

;AND RETURN 

SET^CF: 

©LFCR 

5 DO NEW LINE 


STC 

;SET CARRY FLAG 

ANOTHER 

RET 

ONE ENDP 



MY CODE ENDS 
END 


START 
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EXTENSION 

DB 

3 DUP(0) 

;Extension for filename 




;<i. e. •ASM) 

BLOCK NUMBER 

DU) 

0 

;Current block number 

RECORD SIZE 

DUI 

0 

;Logical record size 

file_sTze 

DU) 

a DUP(0) 

;Double word for size of 




5 file in bytes. 

FILE.DATE 

DU) 

0 

;Date of last access. 

RESERVED 

DT 

0 

;Ten reserved bytes for DOS 

RECORD NUMBER 

DB 

0 

;Current record number 

RANDOM_NUMBER 

DU) 

a DUP<0) 

;4 byte random record number 

MESSAGE1 

DB 

’Enter the 

drive and filename ’ 


DB 



MESSAGEa 

DB 

invalid filename, please reenter. ’ 


DB 



MESSAGES 

DB 

’ ERROR! Operation aborted.’ 


DB 



MESSAGE4 

DB 

’Sequential read complete.’ 


DB 



MESSAGES 

DB 

’File not 

found. ’ 


DB 



MY DATA ENDS 





j********************'**************************'*****''*"*'********'****** 

;Define stack area. 

MY_STflCK SEGMENT PPRfi STOCK ’STACK’ 

DW 32 DUP<0) 564 words of stack. 

MY_STflCK ENDS 

.****#*******************•*•****************•»********************* 

;Define the program. 

MY_CODE SEGMENT PflRfi ’CODE’ 

STftRT PROC FPR 

fiSSUME CS:MY_CODE,DSsMY_DRTfl,ES:MY_DfiTft,SS:MY_STflCK 


STftRT 1; 


PUSH 

DS 

XOR 

X 

a 

X 

<r 

PUSH 

AX 

MOV 

AX,MY DATA 

MOV 

DS, AX 

MOV 

ES, AX 


Save segment of PSP 
Zero offset to stack 

Initialize DS and ES 


START a: 

eSCROLL 06,00,18H,4FH, 00, 00,07 

eVDLINE MESSAGE1 

eCRLF 

MOV MAX^CHARS,15 


GET NAME: 

C-KBDLINE KEYBOARD 


;Clear the screen 
;Ask for the filename 
;Go to the next line- 
;15 Characters maximum 
•,as in B:TESTFILE.TXT<CR> 

;Get line from keyboard. 


ePARSE.STRING K^BUFF,FCB^l,03H 

CALL OPEN^FILE 

JC START^S 

SET UP: 

©SET DTA DISK^BUFFER 


;Parse the filename 
;and place it in the FCB 
;Go open the file 
;If the carry is set then 
;TRY AGAIN! File not found. 

;Set the Disk transfer address 
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MOV 

RECORD NUMBER,© 

MOV 

BLOCK NUMBER,© 

MOV 

REC0RD^SIZE,51£ 

REPD RECORD: 


©REPD 

.SRECORD FCB^l 


CMP 

PL,©©H 

JZ 

CONTINUE 

REPD^ERRORs 

DEC 

PL 

JZ 

EOF FOUND 

DEC 

PL 

JZ 

DISK ERROR 

DEC 

PL 

JNZ 

DISK^ERROR 

XOR 

DI,DI 

DSP^PPRTIPLs 

MOV 

DL,DISK BUFFERCDI3 

CMP 

DL,IPH 

JZ 

EOF FOUND 

©CHPRDSP 

INC 

DI 

JMP 

SHORT DSP PPRTIPL 

CONTINUES 

©VDLINE 

DISK BUFFER 

©CRLF 

JMP 

REPD RECORD 

EOF FOUND: 

©VDLINE 

MESSPGE4 

©CRLF 

JMP 

SHORT EXIT 

DISK ERROR: 

©VDLINE 

MESSPGE3 


@CRLF 

EXITS 

©CLOSE FCB 1 
RET 

STftRT ENDP 


;lst record 
;lst block 

;Record size equal to 512 bytes 

; Sea uent i a 1 read funct i ori 
5 using the FCB defined 
;in the data segment. 

;If zero then OK. 


If PL = 1 then EOF encountered 
no data in record. 

If PL = £ then no room in the 
DTP 

If PL = 3 then EOF encountered 
partial record read. 

If not 03 then unrecoverable 
disk error occurred. 

Zero the index register 

Get the character from buffer 
EOF character? 
exit if so. 

Display the character. 

Point to the next character. 
Continue. 

Disolay the record. 

Go read the next record. 

Display end of program message. 
DONE 

Display error message 


5 Close the file. 

;End of this procedure 


;Procedure to open a file specified in the FCB. 


; 

OPEN FILE 

©OPEN 

CMP 

JZ 


PROC NEPR 
FCB_.l 
PL,00H 
RESET CPRRY 


©VDLINE MESSPGE2 
©CRLF 

XOR DI,DI 

MOV CX,15 


;Open the file 

;If zero then open was successful 
;Reset the carry to indicate to 
5 calling procedure the oaeration 
;worked. 

;Reent er fi1enarne. 

;Clear the keyboard buffer. 

;Clear the keyboard buffer 
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CLRs 


MOV 

K BUFFCDI3,a0H 5 


INC 

DI 

5 Point to th^ next 

byte. 

LOOP 

CLR 

;Continue till CX 

= 0 

C-CLOSE 

FCB_1 

5 Close the file 


STC 


;Set the carry to 

indicate error 

JMP 

SHORT 

D0NE_0_F ;and ret urn 


RESET CARRY: 


5 Clear the carry 


CLC 



DONE 0 F: 




RET 


;And return. 



OPEN_FILE ENDP 

**************************************************************** 
MY^CODE ENDS 
END 


START 
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Listing 8-2 
NEW COPY.ASM 


PAGE 60,132 
TITLE NEW^CdPY.ASM 

SUBTTL SEQUENTIAL READ/WRITE EXAMPLE 
.XLIST 

INCLUDE BzDOSEQU.EQU 
.LIST 

IFl 

INCLUDE BsMACFLE. MAC 
END IF 

;************************************************************ 
jSequential Read/Write Example. 

5 By: Gary A. Shade 
5 Date: 07-10-84 
5 Last Updated: 08-21-84 
; <c) All rights reserved. 


5 This program will copy the contents of one file to another. 

;The user is prompted for the source filename, and then for the 
;destination fi1eharne. 

5 If the destination file already exists, the file length is set 
;to zero, effectively erasing the previous contents of the file- 
; If the source filename is not found, the program will terrninate. 
5 

;This function is similar to the copy command used in MSDOS. 

;It serves to illustrate the sequential read and write functions 
;available under MSDOS. 

; 

;The macros used in thi6 file can be found in the MACFLE. MAC 
;file. MACFLE. MAC expects that the DOSEQU. EQU file is present 
;in the assembly. 

;Define the data segement. 


MY DATA SEGMENT 

PARA 

» DATA’ 


KEYBOARD 

LABEL 

BYTE 


MAX^CHARS 

DB 

7 

;Maximum characters 
;for keyboard line input 
;function. 

CHARS^TYPED 

DB 

7 

5 Actual number of characters 
;typed by user. 

K^BUFF 

DB 

32 DUP<?) 

;32 byte buffer 

DISK^BUFFER 

DB 

0 

;Source and destination 
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disk transfer area- 


FCB 1 

LABEL 

BYTE 

;Disk FCB definition 

DRIVE^NUMBER 

DB 

0 

;0 = default drive 
;1 = A 
;2 = B 

FILE^NAME 

DB 

8 DUP(0) 

;Filename spec. 

EXTENSION 

DB 

3 DUP<0) 

;Extension for filename 
;(i.e. -ASM) 

BLOCK NUMBER 

DUi 

0 

;Current b1ock nurn ber 

RECORD SIZE 

DUI 

0 

;Logical record size 

FILE^SIZE 

m 

2 DUP(0) 

;Double word for size of 
;file in bytes. 

FILE DATE 

DU 

'0 

;Date of last access. 

RESERVED 

DT 

0 

;Ten reserved bytes for DOS 

RECORD NUMBER 

DB 

0 

;Current record number 

RfiNDOM^NUMBER 

DU 

2 DUP<0) 

54 byte random record number 

FCB 2 LABEL 

BYTE 


;Destination FCB 

DRIVE^NUMBER^D 

DB 

0 

;0 = default drive 
;1 = A 

52 = B 

FILE NAME D 

DB 

8 DUP(0) 

;Filename spec. 

EXTENSION^D 

DB 

3 DUP(0) 

;Extension for filename 

5 <i.e. .ASM) 

BLOCK NUMBER D 

DU 

0 

;Current block number 

RECORD SIZE D 

DU 

0 

;Logical record size 

FILE^SIZE_.D 

DU 

2 DUP(0) 

;Double word for size of 
;file in bytes. 

FILE DATE D 

DU 

0 

;Date of last access. 

RESERVED D 

DT 

0 

;Ten reserved bytes for DOS 

RECORD NUMBER D 

DB 

0 

;Current record number 

RANDOM NUMBER D 

DU 

2 DUP<0) 

•4 byte random record number 


MESSAGE1 

DB 

’Enter the source drive and filename ’ 


DB 


MESSAGE1.1 

DB 

’Enter the destination drive and filename ’ 


DB 


MESSAGE2 

DB 

’Invalid filename, please reenter- ’ 


DB 


MESSAGES 

DB 

’ERROR! Operation aborted.’ 


DB 


MESSAGE4 

DB 

’File copy complete-’ 


DB 


MESSAGES 

DB 

’File not f 0 und.’ 


DB 


MESSAGES 

DB 

’New File!’ 


DB 


MESSAGE? 

DB 

’Existing File Over Uritten. ’ 


DB 


MESSAGES 

DB 

’Copy has started .. ’ 


DB 

’$’ 

MESSAGES 

DB 

’Disk full, operation aborted!’ 


DB 

’$’ 

MESSAGE10 

DB 

’Not enough room in DTA to write 1 record. ’ 


DB 

’0perat ion aborted.’ 


DB 


BYTE COUNT 

MY DATA ENDS 

DB 

0 ;Used as a byte counter during disk writes. 
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Listing 8-2 continued 

;Define stack area. 

m 

MY.STftCK SEGMENT PftRft STPCK ’STftCK’ 

DW 33 DUP(0) ;64 words of stack. 

MY^STftCK ENDS 

;*************♦*#******♦**************************************** 
5 Define the program. 

5 

MY^CODE SEGMENT PflRft ’CODE’ 

STPRT PROC FflR 

ftSSUME CS:MY^CODE,DS:MY^DATP,ES:MY^DATA,SS;MY^STACK 


START 1: 

PUSH 

XOR 

PUSH 

MOV 

MOV 

MOV 


DS 

AX, AX 
AX 

AX,MY DATA 
DS^ AX 
ES, AX 


;Save segment of PSP 
;Zero offset to stack 

;Initialize DS and ES 


START 28 

©SCROLL 06,00,leH,4FH, 00, 00, 07 
eCURSET 0,0,0 
©VDLINE MESSAGE1 
©CRLF 

MOV MAX^CHARS,15 

GET NAME: 

©KBDLINE KEYBOARD 

©CRLF 

©PARSE^STRING K^BUFF,FCB_1,03H 

CALL OPEN FILE 

JNC SET-UP 

eVDLINE MESSAGE4 
©CRLF 

JMP SHORT START 2 

SET UPs 

©SET^DTA DISK^BUFFER 

MOV RECORD NUMBER, 0 

MOV BLOCK NUMBER,© 

MOV RECORD SIZE,1 

GET DESTINATION: 

CALL GET SECOND 

eVDLINE MESSAGES 
©CRLF 

READ RECORD: 

©READ SRECORD FCB 1 


CMP AL,00H 

JZ CONTINUE 

READ^ERROR: 

CMP AL,01H 


;Clear the screen 
5 Set the cursor. 

5 Ask for the source filename 
5 Go to the next line. 

515 Characters maximum 
5 as in B:TESTFILE.TXT<CR> 

5 Get line from keyboard. 


5 Parse the filename 
5 and place it in the FCB 
5 Go open the file 
5 If the carry is set then 
5 TRY AGAIN! File not found. 

5 Display error message 

5 Try again. 

5 Set the Disk transfer address 
5 for the destination drive 
51 st record 
51 st block 

5 Record size equal to 1 byte 

5 Get the second drive spec. 
;Display copy started message 


5 Sequential read function 
5 using the FCB defined 
5 in the data segment. 

;If zero then OK. 


5 If AL = 1 then EOF encountered 
:no data in record. 
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JE 

EOF^FOUND 

ERR 3: 


JMP 

DISK.ERROR 


CONTINUE: 


©WRITE 

SRECORD FCB 2 

CMP 

AL,00H 

JNZ 

WRITE ERROR 

INC 

BYTE COUNT 

JNZ 

GET NEXT 


MOV 

DL,» 

©CHARDSP 

GET NEXT: 


JMP 

READ^RECORD 

EOF FOUND: 


MOV 

DL, 

©CHARDSP 

©CRLF 


©VDLINE 

MESSAGE4 

©CRLF 


JMP 

SHORT EXIT 

WRITE ERROR: 


DEC 

AL 

JNZ 

CHK DTA ERROR 

©VDLINE 

MESSAGES 

©CRLF 


JMP 

SHORT EXIT 

CHK^DTA^ERROR: 


DEC 

AL 

JNZ 

DISK ERROR 

©VDLINE 

MESSAGE10 

©CRLF 


JMP 

SHORT EXIT 

DISK ERROR: 


©VDLINE 

MESSAGES 

©CRLF 


EXIT: 


©CLOSE 

FCB 1 

©CLOSE 

FCB_2 

RET 


START ENDP 



;disk error occurred. 

;Else a partial record was 
5 read. 

;Write the record to disk 
•00 s Success 

;If not zero then there was an error 
;Increment memory. 

;If byte rolls over to zero 
;then display asterisk 
;represents 256 bytes written 
;so far. 

5 Display * for show 


•Go read the next record. 

;Show a - for end of file 

;next display line 
;Display end of program message. 

;DONE 

;If AL = 01 then disk full 
;Display error message 
;Leave program 


;If AL = 02 then not enough 
5 room in the DTA 
;Undefined condition if AL>2 
;Display error message 


5 Display error message 


;Close the file. 

;Close the file. 

;End of this procedure 


;Procedure to open a file specified in the FCB. 


OPEN^FILE 

©OPEN 

CMP 

JZ 


PROC NEAR 
FCB^l 
AL,00H 
RESET CARRY 


©VDLINE MESSAGE2 
©CRLF 

CALL CLR_KEYS 


5 Open the file 

;If zero then open was successful 
;Reset the carry to indicate to 
;calling procedure the operation 
; worked. 

;Reent er fi1ename. 

;Clear the keyboard buffer 
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Listing 8-2 continued 

@CL0SE FCB_1 ;Close the file 

STC 5 Set the carry to indicate error 

JMP SHORT DONE 0 F 5 and return 

RESET^CARRY: 

CLC ;Clear the carry 

DONE^O^F: 

RET ;ftnd return. 

OPEN^FILE ENDP 

;#************************************************************** 

;Procedure to obtain destination filename and create the file. 

; 

BET.SECOND PROC NEPR 

©VDLINE MESSAGE1 1 
©CRLF 

MOV MAX^CHARS,15 

GET NAME D: 

CALL CLR KEYS 

©KBDLINE KEYBOARD 

@CRLF 

ePARSE^STRING K^BUFF,FCB_2,03H ;Parse the filename 

;and place it in the FCB 
©CREATE^FILE FCB^£ 5 Open the file 

CMP AL,O0H ;If zero then open existing file 

JNZ NEW FILE ;If not zero then a new file 

0VDLINE MESSAGE? ;Existing File message 

©CRLF 
SET^UP^D: 

MOV RECORD^NUMBER D, 0 5 1st record 

MOV BLOCK^NUMBER^D,0 ;lst block 

MOV RECORD_SIZE_D, 1 5 Record size equal to 1 byte 

JMP SHORT DONE 0 F_D ;Return with carry clear 

NEW FILE: 

©VDLINE MESSAGES ;New file 

©CRLF 

JMP SHORT SET UP^D \SBt up destination FCB 

DONE^O^F^D: 

RET ;And return. 

GET.SECOND ENDP 

;Clear the keyboard buffer area 


CLR. 

KEYS 

PROC 

NEAR 




XOR 

DI,DI 


;Clear the keyboard 

buffer 


MOV 

CX, 15 


;Clear the keyboard 

buffer 

CLR 

: 






MOV 

K BUFFCDI3,20H 

5 



INC 

DI 


;Point to the next 

byte. 


LOOP 

CLR 


;Continue till CX = 

0 


RET 



;A11 done 


CLR 

KEYS 

ENDP 





MY^CODE ENDS 

END START 


;Ask for the destination filename 
;Go to the next line. 

;15 Characters maximum 
;as in B:TESTFILE.TXT<CR> 

;Clear keyboard buffer 
:Get line from keyboard. 
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Listing 8-3 
FAST CPY.ASM 


PAGE 60,132 
TITLE FAST__COP. ASM 

SUBTTL RANDOM BLOCK READ/WRITE EXAMPLE 
.XLIST 

INCLUDE B:DOSEQU.EQU 
-LIST 

IFl 

INCLUDE BrMACFLE.MAC 
END IF 

.************************************************************ 

;Random Block Read/Write Examole. 

5 By: Gary A- Shade 
;Date: 07-10-84 
5 Last Updated: 08-21-84 
5 (c) All rights reserved- 


This program will copy the contents of one file to another. 

The user is prompted for the source filename, and then for the 
destination fi1ename. 

If the destination file already exists, the file length is set 
to zero, effectively erasing the previous contents of the file. 
If the source filename is not found, the program will terminate. 

This function is similar to the copy command used in MSDOS. 

It serves to illustrate the sequential read and write functions 
I available under MSDOS. 

The macros used in this file can be found in the MACFLE.MAC 
file. MACFLE.MAC expects that the DOSEQU.EQU file is oresent 
I in the assembly. 


************************************************************** 
Define the data segement. 


MY DATA SEGMENT 

PARA 

’DATA’ 


KEYBOARD 

LABEL 

BYTE 


MAX^CHARS 

DB 

9 

;Maximum characters 




;for keyboard line inout 
;function. 

CHARS_TYPED 

DB 

7 

5 Actual number of characters 




;typed by user. 

K^BUFF 

DB 

32 DUP(?) 

532 byte buffer 

DISK^BUFFER 

DB 

7FFFH DUP<0) 

5 Source and destination 
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Listing 8-3 continued 

;disk transfer area. 


FCB 1 

LABEL 

BYTE 

;Disk FCB definition 

DRIVE^NUMBER 

DB 

0 

;0 = default drive 

FILE^NAME 

DB 

a DUP(0) 

;1 = A 
;£ = B 

;Filename soec. 

FILE NAME 

DB 

a DUP<0) 

;1 = A 
?£ = B 

;Filename spec. 

EXTENSION 

DB 

3 DUP(0) 

;E X t ension for fi 1 enarne 

BLOCK NUMBER 

DN 

0 

;(i.e. .ASM) 

;Current block number 

RECORD SIZE 

DN 

0 

;Logical record size 

FILE^SIZE 

DU 

2 DUP(0) 

;Double word for size of 

FILE DATE 

DN 

0 

;file in bytes. 

;Date of last access. 

RESERVED 

DT 

0 

;Teri reserved bytes for DOS 

RECORD NUMBER 

DB 

0 

5 Current record number 

RANDOM^NUMBER 

DN 

£ DUP(0) 

;4 byte random record number 

FCB £ LABEL 

DRIVE^NUMBER^D 

BYTE 

DB 

0 

;Destination FCB 
-0 5 = default drive 

FILE NAME D 

DB 

8 DUP(0) 

;1 = A 
;£ = B 

;Filename soec. 

EXTENSION^D 

DB 

3 DUP<0) 

;Extension for filename 

BLOCK NUMBER D 

DN 

0 

;(i.e. .ASM) 

;Current block number 

RECORD SIZE D 

DW 

0 

;Logical record size 

FILERSIZE_D 

DU 

£ DUP(0) 

;Double word for size of 

FILE DATE D 

DU 

0 

5 file in bytes. 

;Date of last access. 

RESERVED 5 

DT 

0 

;Ten reserved bytes for DOS 

RECORD NUMBER D 

DB 

0 

5 Current record number 

RANDOM NUMBER D 

DU 

£ DUP(0) 

;4 byte random record number 


MESSAGE1 

DB 

’Enter the source drive and filename ’ 


DB 


MESSAGEl^l 

DB 

’Enter the destination drive and filename ’ 


DB 

’$’ 

MESSAGE2 

DB 

’Invalid filename, olease reenter. ’ 


DB 


MESSAGES 

DB 

’ERROR! Operation aborted.’ 


DB 

’$’ 

MESSAGE4 

DB 

’File cooy complete.’ 


DB 


MESSAGES 

DB 

’File not found.’ 


DB 


MESSAGES 

DB 

’New File!’ 


DB 

’$’ 

MESSAGE? 

DB 

’Existing File Over Uritten. ’ 


DB 


MESSAGES 

DB 

’Copy has started .. ’ 


DB 


MESSAGES 

DB 

’Disk full, operation aborted!’ 


DB 



MY DATA ENDS 
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.******************************************************************* 
;Define stack area. 

MY^STACK SEGMENT PARA STACK ’STACK’ 

DW 32 DUP(0) ;64 words of stack. 

MY^STACK ENDS 

.*************************************************************** 

;Define the program. 

MY^CODE SEGMENT PARA ’CODE’ 

START PROC FAR 

ASSUME CS: MY_,CODE, DS: MY_DATA, ES: MY^DATA, SS: MY_STACK 


STARTs1: 


PUSH 

DS 

XOR 

AX, AX 

PUSH 

AX 

MOV 

AX,MY DATA 

MOV 

DS, AX 

MOV 

ES, AX 


Save segment of PSP 
Zero offset to stack 

Initialize DS and ES 


START 2: 

C-SCROLL 06,00, 18H,4FH, 00, 00,07 
C-CURSET 0,0,0 
@VDLINE MESSAGE1 
@CRLF 

MOV MAX^CHARS,15 


GET^NAME: 

0KBDLINE KEYBOARD 


;Clear the screen 
;Set the cursor. 

;Ask for the source filename 
•Go to the next line- 
;15 Characters maximum 
;as in BrTESTFILE.TXT<CR> 

;Get line from keyboard. 


C-CRLF 

C-PARSE^STRING REBUFF, FCB^l, 03H 

CALL OPEN^FILE 
JNC SET_.UP 

C-VDLINE MESSAGE4 
@CRLF 

JMP SHORT STARTLE 

SET UP: 

@SET__DTA DISK_BUFFER 

MOV RECORD^NUMBER,0 

MOV BLOCK NUMBER,0 

C-SET^REL_RECORD FCB^l 

GET.DESTINATION: 

CALL GET^SECOND 
C-VDLINE MESSAGES 
C-CRLF 

READ_RECORD: 


;Parse the filename 
;and olace it in the FCB 
;Go open the file 
;If the carry is set then 
;TRY AGAIN! File not found. 

;Display error message 

;Try again. 

;Set the Disk transfer address 
;for the destination drive 
;lst record 
;lst block 

;Set the random relative record 
5 field in the FCB. 

;Get the second drive soec. 

;Display copy started message 


@BLOCK_.RREAD FCB_1,7FFFH, 1 ;Random Block Read 

;using the FCB defined 
;in the data segment. 

CMP AL,00H ;If zero then OK. 

JZ CONTINUE 
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Listing 8-3 continued 

REPD ERROR: 


CMP 

AL,01H 

:If AL = 1 then EOF encountered 

JE 

PARTIAL 3 

;LAST RECORD COMPLETE 

ERR 3: 

CMP 

AL,03H 

5 lf AL = 0£H then EOF with 

JZ 

PARTIAL 3 

;partial v'ecord read. 

JMP 

DISK ERROR 

5 disk error occurred. 

PARTIAL 3: 

CMP 

CX,0 

;If ho records read then skio 

JZ 

EOF FOUND 


MOV 

BX,CX 

:Put record count in BX 

C-BLOCK 

RWRITE FCB S,BX,1 

•Write the partial block to disk 

JMP 

SHORT EOF^FOUND 


CONTINUE: 



C-BLOCK 

RWRITE FCB £,7FFFH,1 

;Write the record to disk 

CMP 

AL,00H 

;00 = Success 

JNZ 

WRITE__ERROR 

;If not zero then there was an error 

GET NEXT: 



JMP 

READ^RECORD 

•Go read the next record. 

EOF FOUND: 


f 

MOV 

DL, 

:Show a - for end of file 

©CHARDSP 


@CRLF 


;next display line 

©VDLINE 

MESSAGE4 

;Display end of program message. 

@CRLF 

JMP 

SHORT EXIT 

;DONE 

WRITE^ERROR: 

DEC 

AL 

;If AL = 01 then disk full 

JNZ 

CHK SIZE ERROR 

;Disk full error 

©VDLINE 

MESSAGES 

;Display error rnessaoe 

C-CRLF 

JMP 

SHORT EXIT 

;Leave program 

CHK_.SIZE_ERROR: 

C-VDLINE 

MESSAGES 

;Display error message 

C-CRLF 

JMP 

SHORT EXIT 


DISK ERROR: 

C-VDLINE 

MESSAGES 

;Display error message 

eCRLF 

EXIT: 

eCLOSE 

FCB 1 

;Close the file. 

C-CLOSE 

FCB^S 

;Close the file. 

RET 

START ENDP 


;End of this procedure 


Procedure to ooen a file soecified in the FCB. 


OPEN__FILE PROC NEAR 

0OPEN FCB^l ;Open the file 

CMP fiL,00H ;If zero then ooen was successful 

JZ RESET_CARRY 5 Reset the carry to indicate to 

;calling procedure the operation 
5 worked. 

;Reenter fi1ename. 


@VDLINE MESSAGES 
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©CRLF 

CALL 

<^CLOSE 

BTC 

JMP 

RESET CARRY: 

CLC 

DONE 0 F: 

RET 

OPEN^FILE 


CLR_KEYS ;Clear the keyboard buffer 

FCB^l ;Close the file 

5 Set the carry to indicate error 
SHORT DONE^O^F ;and return 

;Clear the carry 


ENDP 


;And return. 


;*************************************************************** 
•Procedure to obtain destination filename and create the file. 


GET SECOND PROC NEAR 


eVDLINE MESSAGEl^l 
0CRLF 

MOV MAX^CHARS,15 

GET_NAME_D: 

CALL CLR^KEYS 

©KBDLINE KEYBOARD 


;Ask for the destination filename 
;Go to the next line. 

;15 Characters maximum 
;as in B:TESTFILE.TXT<CR> 

;Clear keyboard buffer 
;Get line from keyboard. 


§CRLF 

ePARSE_.STRING REBUFF, FCB.£, 03H ; Parse the filename 


C-CREATE.F ILE FCB_£ 

CMP AL,00H 

JN2 NEW FILE 

©VDLINE MESSAGE? 

C-CRLF 
SET UP_D: 

MOV RECORD^NUMBER D, 0 

MOV BLOCK^NUMBER.D, 0 

MOV RECORD^SIZE D, 1 

©SET^REL^RECORD FCB^S 
JMP SHORT D0NE_0_F__D 

NEWSFILE: 

@VDLINE MESSAGES 
0CRLF 
JMP 

DONE^O^F^D: 

RET 


;and dace it in the FCB 
5 Open the file 

;If zero then ooen existing file 
;If not zero then a new file 
;Existing File message 


1st record 
1st block 

Record size equal to 1 byte 
Set the relative record field 
Return with carry clear 


New file 

SHORT SET_UP_D ;Set up destination FCB 
;And return. 


GET SECOND ENDP 


************************************************************* 
;Clear the keyboard buffer area 


CLR^ 

KEYS 

PROC 

NEAR 




XOR 

DI,DI 


;Clear the keyboard 

buffer. 


MOV 

CX, 15 


;Clear the keyboard 

buffer 

CLR: 






MOV 

REBUFF CD13,£0H 

5 



INC 

DI 


;Point to the next 

byte. 


LOOP 

CLR 


;Continue till CX = 

0 


RET 



;A11 done 


CLR_ 

KEYS 

ENDP 





MY^CODE ENDS 

END START 
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Listing 8-4 
DIRREAD.ASM 


PPGE 60,132 

TITLE Directory Read Routine. 

SUBTTL Directory Sort. 

.XLIST 

INCLUDE B:DOSEQU.EQU 
.LIST 

IFl 

INCLUDE BrMACFLE.MPC 
END IF 

This program will read and sort the directory from the 
specified disk drive. The number of entries which are 
displayed is limited to the the screen size. 

Entries are listed four accross, for a total of 
4 X 24 directory entries. 

This program uses DOS interrupt type 25H for 
absolute disk reads. 

DIRESORT is the routine which will alphabetize and sort 
the entries prior to display. 

Possible disk formats are: 

Single Sided/8 sectors per track (SS8ST) 

Double Sided/8 sectors per track (DS8ST) 

Single Sided/9 sectors per track (SS9ST) 

Double Sided/9 sectors per track (DS9ST) 

Use the first byte of FPT to determine the drive type: 

FF = DS8ST 
FE = SS8ST 
FD = DS9ST 
FC = SS9ST 
F8 = Hard disk. 

********************************************************* 
The procedure GET_DRIVE_TYPE will set the parameters for 
the drive type requested dependent upon the 1st byte of the 
FftT. 

Version 1.0 formats. 

***************************************************** 

IF SS8ST 

DIR^SEC = 4 
DIR^BEG = 3 
ENTRIES = 64 
ELSE 
IF 

DIR SEC = 7 


DS8ST 


;Number of directory sectors 
;Where the directory begins 
;Number of directory entries 
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;DIR BEG = 3 
;ENTRIES = 112 

;Version 2.0 and 2.1 

• ***************************************************** 

; IF SS9ST 

5 DIR SEC = 4 
;DIR BEG = 5 
;ENTRIES = S4 
; ELSE 

; IFE DS9ST 

;DIR_SEC = 7 
;DIR_BEG = 5 
;ENTRIES = 112 

5 **************************************************** 

;Define Stack Segment. 

MY STACK SEGMENT PARA STACK ’STACK’ 

DW 100 DUP(?) 

TOP^OF STACK EQU ^ 

MY^STACK ENDS 

******************************************************** 
MY^DATA SEGMENT PARA ’DATA’ 

;***** Keyboard buffer ********************************* 


K BUFFER 

LABEL 

BYTE 


MAX CHARS 

DB 

0 :INITIALIZE TO 0. 

CHARS TYPED 

DB 

0 ;SAME 

HERE. 

K BUFF 

DB 

32 DUP<’ ’ ) 

;32 BYTES = ASCII SPACE 

5 ********* Buffer for 

Directory read 

******************** 

FCB 

DB 

40 DUP<0) 

5 File Control Block 

DIR BUFF 

DB 

4096 DUP(0) 

;Disk Transfer Address 

DIR_BUF2 

DB 

2048 DUP(0) 

5 Secondary buffer used 




;for sorting. 

MESSAGE1 

DB 

’Disk Error, 

returning to MSDOS’ 


DB 


5 MESSAGE TERMINATOR. 

MESSAGE2 

DB 

’Which drive 

(A, B)? ’ 


DB 



MESSAGES 

DB 

’Invalid entry! Please reenter ’ 


DB 

’$’ 


ENTRY COUNTER 

DB 

00H 

;Entry count. 

ERR COUNT 

DB 

00H 

;Error counter 

DRIVE 

DB 

00H 

;Drive number (0=A) 

MIN 

DB 

00H 

;Minimum value for bounds 

MAX 

DB 

00H 

;Max. value for bounds check 

EXCHANGE 

DB 

00H 

;Swap flag for sort 




;00 == no swap 




•01 = swap 

NAMES^DISPLAYED 

DB 

00H 

;Number of names on the 




;display. 

DIR SEC 

DM 

00H 

;Number of sectors to read 

DIR BEG 

DUi 

00H 

;Beginning directory number 

ENTRIES 

DN 

00H 

;Number of possible entries 




;drive format 

DELAY COUNT 

DW 

07FFH 

5 Inner loop delay count 

LOOP VALUE 

DW 

0100H 

:Number of times to execute 


5 the outer loop of the delay. 

MY^DATA ENDS 

;********************************************************** 


MY CODE SEGMENT PARA ’CODE’ 
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Listing 8-4 continued 



ASSUME 

CS:MY_CODE, DS:MY 

^DATA, ES: MY^DATA, SS: MY__STACK 

STPRT 

PROC 

FAR 


BEGINl: 

PUSH 

DS 

;SAVE RETURN ADDRESS 


XOR 

AX, AX 

;ZERO ACCUMULATOR 


PUSH 

AX 

5 SAVE RETURN SEG. OFFSET. 


MOV 

AX,MY DATA 

;SET UP SEG REGISTERS 


MOV 

DS, AX 



MOV 

ES, AX 



PUSH 

ES 

;Save ES 


eSET DTA DIR BUFF 

;Set the disk transfer address 


POP 

ES 

;Restore value 

;******** Clear 

the screen and set the cursor ********************** 

BEGINS: 

NOP 




C-SCROLL 

06,00, 18H,4FH,00 

,00,07 ;Clear the screen 


NOP 




C-CURSET 

0 , 0 , 0 

;Set the cursor to row 0, col 0, 




;screen 0 - 

PROMPT: 

NOP 




eVDLINE 

MESSAGES 

;Ask user which drive. 


©WAITKEY 

5 Get the response in AL. 


AND 

AL,010nillB 

;Reset bit 5, convert 




5 to uppercase 


MOV 

MIN,41H 

;Ascii ’A’ is minimum 


MOV 

|viAX,44H 

:Ascii ’D’ is maximum 


CALL 

CHECK BOUNDS 

;See if response is valid. 


JNC 

ALL RIGHT 

;If carry not set then continue. 

ENTRY^ERROR: NOP 



eVDLINE 

MESSAGES 

;Display error message 


CALL 

LONG^DELAY 

5 Twiddle some thumbs, leave 




;the message on the screen. 


JMP 

BEGINS 

;Restart Program. 

PLL RIGHT: 

AND AL,0FH 

;Mask high order nibble 


DEC 

AL 

SDecrement AL register. 




;If Drive A, then AL =0 




5 B = 1, C = 2, etc. 


MOV 

DRIVE,AL 

;Save drive number 


CALL 

GET DRIVE TYPE 

;Determine the drives format 


LEA 

BX,DIR BUFF 

5 Disk Transfer Address 


MOV 

CX,DIR SEC 

;Number of sectors to read 


MOV 

DX,DIR BEG 

;Beginning relative sector. 


INT 

S5H 

;Perform absolute sector read. 


POPF 


;Retrieve status. 


JNC 

NO_ERR 

;If no error then continue. 


CALL 

ERR ROUTINE 

;Otherwise go to error handler 


JC 

TOO MANY 

;Too many errors, abort 


JMP 

BEGINS 

;And restart the program. 

NO^ERR: 

CALL 

DIR SORT 

;Go sort directory. 


CALL 

DIR^DSP 

5 G 0 display it. 


@CRLF 


;Go to the next line 

QUIT IT 

: JMP 

SHORT ALL^DONE 

! ;Return to DOS exit ooint 

TOO MANY: NOP 




©VDLINE 

MESSAGE1 ;Error 

message. 


CALL 

LONG^DELAY 

;Wait for a awhile (display mssg) 
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©SCROLL 06,00,18H,4FH,00,00,07 ;Clear the screen 
ALL_DONE: RET ;Return to DOS 


STPRT ENDP 


;************************************************************** 
;Bounds checking routine. This routine will comoare the 
5 binary value in PL to the upper and lower limits set in 
;RAM locations MIN and MAX- If the routine finds the value 
;out of bounds, the carry will be set. Otherwise the 
;routine will return control with the carry reset. 


CHECK^BOUNDS 

CMP 

JB 

CMP 

JA 

CLC 

JMP 

OUT^BOUNDS: STC 

CB^DONE: 

CHECK BOUNDS 


PROC NEAR 
AL,MIN 
OUT^BOUNDS 
AL,MAX 
OUT^BOUNDS 

SHORT CB^DONE 

RET 

ENDP 


;Is AL < MIN? 

;JumD if AL is below. 

•Is AL > Max? 

;JumD if AL is above rnax- 
;Otherwise, clear carry- 
; Ret urn do i nt 
;Set the carry flag- 
;Ret urn to caller- 


;******************************************************** 
;This routine will orovide for a software delay of variable 
;length. Uses BX and CX. All registers used are restored 
;prior to exiting this routine. 


LONG DELAY 

PUSH 

PUSH 

MOV 

IN.LOOPl: MOV 
IN L00P2: DEC 
JNZ 
LOOP 
POP 
POP 
RET 

LONG DELAY 


PROC NEAR 

BX 

CX 

CX,DELAY_COUNT 

BX,LOOP_VALUE 

BX 

IN_L00P2 

IN__L00P1 

CX 

BX 

ENDP 


Save registers used in routine. 

Get count value 
Get looD value 
Decrement inner loop count 
Lood if BX is not zero. 

Lood if CX is not zero. 

Restore registers 

All done, return to caller. 


;*********************************************************-K-*4(>* 

;This routine is the error handler for disk access. If there 
;is an error during disk access, the memory location 
;ERR_COUNT is incremented- If the count is greater than 
;10, the ooeration is aborted, and the program is restarted- 
5 If the count is less than ten, the operation is retried. 

5 The main program determines this from the state of the carry flag 
;on return from this routine. If the carry is set, then the 
;operation should be aborted. 


ERREROUTING 
INC 
CMP 
JAE 
CLC 
JMP 

MORE^TEN: 
ERR_DONE: 
ERR ROUTINE 


PROC NEAR 
ERR^COUNT 
ERR^COUNT,11 
MORE^TEN 

SHORT ERR^DONE 

STC 

RET 

ENDP 


;Increment memory 
;More than 10 errors? 
;If so, then set carry 
;Else clear the carry 
; Ret urn do i nt 
;Set the carry flag. 

;Ret urn to caller 


*********************************************************** 
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Listing 8-4 continued 

;This routine will sort the directory read in from disk. 

5 The directory will reside in the memory buffer area DIREBUFF 
5 after the disk read operation. 

;The format of the directory is: 

;Track 0, Sectors 4-7 

;Bytes 0-7 Filename. If byte 0 = 00H then entry never used. 

■ E5H then entry has been deleted 

• £EH then the entry is for a directory 

; ftny other character found in byte 0 is the first 

; character of the filename. 

•8-10 The file name extension- 
;11 The File attribute 01 = Read Only 

; 02 = Hidden File 

; 04 = System File 

; 00 = Volume Label (in bytes 0-10) 

; 10 = Subdirectory 

; 20 = Archive Bit, set whenever 

; the file has been written to and 

; closed, and has not been backed uo 

;12-21 Reserved By MSDOS 

;22-23 The time the file was last updated or created. 

; Format: Bll-15 = Hour (0-23) 

; B5-10 = Minutes (0-59) 

• B0-4 = two-second increments 

• Least significant byte = Byte 22 

5 Most Significant Byte = Byte 23 

;24-25 Date of file creation or update. 

5 Format: B8-15 = Year (0-119 = 1980-2099) 

; B5-7 = Month (1-12) 

• B4-0 = Day (1-31) 

; 

526-27 Starting Cluster; See IBM DOS Technical Reference Manual 
5 Page 4-7 and Page 4-10. 

5 28-31 File Size in bytes (Least Significant Word = LSB of the size) 

5 The first part of the procedure extracts the directory filenames 
5 from the DTA which is DI REBUFF 
5 and places it in DIR_BUF2. 

5 This is where the directory will be sorted. 


DIRESORT 

PROC 

NEAR 


MOVE^DIR: 

MOV 

CX,ENTRIES 

5 Number of entries in dir. 




5 move. 


LEA 

DI,DIR BUF2 

;Set destination register 


LEA 

SI,DIR_.BUFF 

5 Source DS:SI 


CLD 


;Clear direction flag 




;for auto increment 


SUB 

BX,BX 

:Zero base register 

M0VE^DIR2: 

CMP 

DIR BUFFCBX3, 

00H 5 Entry never used? 


JZ 

GET NEXT 

5 If so then get next record 


CMP 

DIR BUFFCBX3, 

0E5H ;EmDty due to deletion? 


JZ 

GET NEXT 

5 If so then get next entry 

M0VE_DIR3: 

PUSH 

CX 

5 Save number of entries 


MOV 

CX, 11 

5 Filename and extension 

REP 

MOVSB 


5 Move f i 1 enarne 


ADD 

BX,32 

5 Offset to next entry 


ADD 

SI,32-11 

5 Point to next entry 
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POP 

CX 

;Recover number of entries 


JMP 

SHORT GET NEXT2 

;Continue from here 

GET_NEXT: 

ADD 

BX,3£ 

;Point to next entry 


ADD 

SI, 32 

5 If we did not find an entry. 

GET.NEXTB: 

INC 

ENTRY COUNTER 

;Increment entry found counter 


LOOP 

MOVE DIR2 

;Continue for all entries 


*************************** 

;Now sort the 

entries 

into alphabetical 

order. 

;Use bubble sort technique. 


DIRESORTS: 

MOV 

CL, ENTRY COUNTER :Nurfiber of entries to 


MOV 

CH,0 

;sort. 


MOV 

EXCHANGE,00H 

;Clear the swap flag. 


LEA 

DI,DIR BUF2Cin 

;Destination of compare 


LEA 

SI, DIR BUF2 

;Source for compare 


PUSH 

SI 

:Store pointers on stack 


PUSH 

DI 


D1R_S0RT3: 

PUSH 

CX 

;Save the number of times to 
;execute this routine. 


MOV 

CX,8 

5 Number of bytes to compare 

REPE 

CMPSB 


5 Compare entire string 


JNA 

NO^SWAP 

;If source > destination 
;Else, swap entries 


CALL 

SWAP ENTRY 

;Go swap entries 

NO.SWAP: 

CALL 

ADJ POINTERS 

;Adjust pointers 


POP 

CX 

;Ret rieve co unt 


LOOP 

DIR S0RT3 

;Loop for all entries 


POP 

DI 

;Clean up stack 


POP 

SI 



CMP 

EXCHANGE,0H 

;If not equal to zero 

5 then make another pass 


JNE 

DIR^SORT£ 

;Redo routine if there 
;was an entry swapped. 


RET ;Otherwise return 

DIR.SQRT ENDP 

;Procedure to swap directory entries. Expects the stack to be 
;arranged as follows: 

;SP ”> TOP OF STACK 

; ~ Base Pointer (Pushed by this routine) Bytes 0 |r 1 


5 

- Ret urn 

Address 

1 - 

Bytes 2 & 3 

5 

- Count 

Register 

- 

Bytes 4^5 

5 

- Destination Pointer - 

Bytes 6 & 7 

5 

- Source 

Pointer 


Bytes 8 & 3 

5 

5 

- Ret urn 

Address 

2 - 

Bytes 10 & 11 

5 

;Uses 

the pointers which are saved 

on the stack. 

SWAP_ 

ENTRY 

PROC 

NEAR 




PUSH 

BP 

;Save BP 



MOV 

BP,SP 

5 Point to stack 



MOV 

DI, CBP-^-Sl 

;Recover point ers 



MOV 

SI,CBP+83 

;from stack 



MOV 

CX, 11 

;Number of bytes to exchange 

SWAP_ 

BYTES: 

MOV 

AL,CDI3 

;Get byte to exchange 



XCHG 

AL, csn 

;Bytes exchanged 



MOV 

CDID,AL 

•Save byte from source in dest. 



INC 

SI 

;Point to next byte<s) 



INC 

DI 

5 
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Listing 8-4 continued 



LOOP 

SWAP BYTES 

;Continue unti1 zero. 


MOV 

EXCHANGE,01 

;Show there was an exchange. 


POP 

BP 

;Recover bas register 


RET 


;Return to caller 

SWAP ENTRY 

ENDP 



•***************************************************************** 

ADJ^POINTERS 

PROC 

NEAR 



PUSH 

BP 

;Save base register 


MOV 

BP, SP 

;Point to base of stack 


MOV 

DI,CBP+63 

;Get destination pointer 


MOV 

SI, i:bp+83 

;Get source pointer 


ADD 

DI, 11 

;Point to next filename 


ADD 

SI, 11 

;Point to next filename to compare 


MOV 

CBP+63,DI 

;Resave pointer 


MOV 

CBP+83,SI 

;Resave point er 


POP 

BP 

5 Restore base register 


RET 


;Return to caller 

ADJ^POINTERS 

ENDP 




;This procedure will display the directory entries stored in 
;DIR_BUF2. The procedure will display up to 64 names on the 
;screen at a time, and wait for the operator to press any key before 
;display any remaining entries, fts the double sided formats 
;allow up to 112 directory entries, the pause between screen displays 
;prevents the screen from scrolling before the ooerator can read 
;thB directory names. 


DIR DSP PROC NEftR 

©SCROLL 06,00, 18H,4FH, 00,00,07 


©CORSET 00,00,00 


MOV 

INC 

MOV 

LEft 

DIR_DSP2s PUSH 
MOV 
CMP 
JNE 
POP 


CL,ENTRY COUNTER 
CL 

CH,0 

SI,DIR_BUF2 

CX 

CX 8 

BYTE PTR CSI3,00 

DSP_NEXT_CHAR 

CX 


ADD SI,11 

LOOP DIR^DSP2 

DSP_NEXT_^CHAR: MOV DL, CSI3 

©CHARDSP 
INC SI 

LOOP DSP_NEXT_CHAR 
MOV DL,’.’ 

©CHARDSP 
MOV CX,3 

DSP^EXT: MOV DL,CSIl 

©CHARDSP 
INC SI 

LOOP DSP^EXT 

MOV CX,8 

MOV DL,20H 

DSP^SPACE: ©CHARDSP 

LOOP DSP^SPACE 

INC NAMES DISPLAYED 


Clear screen 
Then set the cursor 
Screen 0, row 0, col 0 
Number of entries in dir. 


Get start of buffer address 

Save entry counter 

Display 8 character filename 

If zero then skip 

If not, then display filename 

Retrieve # of times to execute 

this loop. 

Point to next field. 

Scan ail ent ries 
Get character in filename 
Display character in DL 
Increment source pointer 
Loop till al chars are dsp 
Fi1enarne delimiter 
Display ’ . ’ 

3 character extension 
Get character from buffer 
Display the character 
Point to the next character 
Display all 3 characters 
Display 8 spaces 
ASCII Space 

Do all 6 spaces 

Inc number of names on screen 
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CMP 

NAMES^DISPLPYED, 

80 

;80 NAMES DISPLAYED? 

JB 

CONT DSP 


;If < 80, then continue. 

©WftITKEY 


;Wait for a key to be hit. 

MOV 

NAMES DISPLAYED, 

0 

;Clear filename counter 

CONT DSP: POP 

CX 


;Recover outer loop count 

LOOP 

DIR^DSPE 


;Continue until all files are 
;displayed 

MOV 

NAMES^DISPLAYED, 

0 

;Clear name counter 


RET ;ftll done, do home 

DIR^DSP ENDP 

;******************************************************************** 


;This procedure 

will read the FAT (track 

0, sector 1) via 

;MSDOS interrupt 

type 25H. The byte is the key for the drive type 

;(i.e. single sided/double sided 8/9 sectors/track etc.) 

;See the beginning of this file for the 

possible drive configurations 

:based on the ist byte 

value of the file 

allocation table (FAT). 

GET DRIVE TYPE 

PROC 

NEAR 


PUSH 

AX 


;Save ALL REGISTERS! 

PUSH 

BX 



PUSH 

CX 



PUSH 

DX 



LEA 

BX,DIR 

BUFF 

5 DTA 

MOV 

AL,DRIVE 

;Get drive number 

MOV 

CX,01 


;Read one sector 

MOV 

DX,01 


;AT SECTOR 1 

INT 

25H 


;Absolute disk read 

POPF 



;Any errors? 

JNC 

NO^ERR2 


-,N0 ERRORS, CONTINUE 

STC 



;Else set the carry and return 

JMP 

DONE WITH TYPE 

;Leave this routine. 

NO ERR2: 

LEA 

SI,DIR BUFF 

;Set pointer to first byte 

MOV 

AL,BYTE 

PTR ISll 

;What tyoe of drive is it? 

INC 

AL 


;Increment byte, was it FFH? 

JZ 

SET DS8ST 

50FFH = DS 8 SECTORS/TRACK 

INC 

AL 


;Was it 0FE? 

JZ 

SET ssasT 

;0FEH = SS a Sectors/track 

INC 

AL 


;Was it 0FD? 

JZ 

SET DS9ST 

;0FDH = DS 9 Sectors/track 

JMP 

SHORT 

SET SS9ST 

;Else it is SS 9 Sectors/track 

SET SSSST: 

MOV 

DIR SEC,4 

5 Number of directory sectors 

MOV 

DIR BEG 

,3 

5 Directory start sector 

MOV 

ENTRIES 

,64 

;Number of possible directory 




;entries. 

JMP 

SHORT 

DONE WITH TYPE 

;A11 done, return to caller 

SET_.DS8ST: 

MOV 

DIR SEC,7 



MOV 

DIR BEG, 3 



MOV 

ENTRIES, 112 



JMP 

SHORT DONE^WITH^TYPE 

SET^DS9ST: 

MOV 

DIR SEC,7 



MOV 

DIR BEG,5 



MOV 

ENTRIES, 112 



JMP 

SHORT DONE WITH TYPE 

SET_SS9ST: 

MOV 

DIR SEC,4 



MOV 

DIR BEG, 5 



MOV 

ENTRIES, 64 



CALL 

CLR DTA 

;Clear the DTA 

DONE^WITH^TYPE: 

POP 

DX 

;Restore registers 


POP 

CX 



POP 

BX 



POP 

AX 
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Listing 8-4 continued 

RET ;EKit this procedure 

GET.DRIVE^TYPE ENDP 

;************************************************************ 


CLR DTA PROC 

NEAR 


MOV 

CX,LENGTH DIR BUFF 

;Number of bytes to clear 

LEA 

SI,DIR BUFF 

;Point to first byte of buffer 

CLR DTA2: 

MOV BYTE PTR CSI], 

00H ;Clear the byte 

INC 

SI 

;Increment the address pointer 

LOOP 

CLR DTA2 

;Clear all bytes 

RET 




CLR^DTft ENDP 

;******************************************************************* 
MY CODE ENDS 
END 


START 
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Listing 9-1 
GRAPHIC.ASM 


PAGE 60,132 

TITLE Graphic Routine 

SUBTTL BY: Gary A. Shade 

.XLIST 

INCLUDE B:DOSEQU.EQU 
.LIST 

IFl 

INCLUDE B:MACFLE.MAC 
END IF 

;*********************************************************** 

•Graphic ROUTINE 
;Created: 09-01-84 
;By: Gary A. Shade 
;Date last revised: 09-02-84 

; (c) 1984 Gary A. Shade. All rights reserved. 

5 

5 This file will define a program which demonstrates the use 
:of a procedure to draw lines on the IBM PC. 

;As MSDOS does not offer adeauate graphic routines, the 

5 routine found here will utilize BIOS calls. This may cause some degree 
5 of incompatibility to exist when these macro calls are executed on 
5 the so called ’compatible’ computers. The routine has been tested 
;on an IBM PC and a Compaq computer. 

5 

;♦#**************************************************************** 

5 This procedure will draw a line from a specified start position, 

5 to the specified stop position. There is no check to see if the 
;parameters supplied are within bounds <i.e. row and column min/max 
;values). You must be sure they are within the range for the current 
;graphics mode selected. <320x200 medium res.) 

;and (640 x 200 high res). 

;Use the ©VDMODE macro in MACFLE.MAC to set the video mode 
;as desired. 

5 The routine expects the following RAM locations to contain the 
;values for the starting X-Y, and ending X-Y coordinates. 

5 

5 STARTX = starting x coordinate 

;STARTY = y 

;STOPX = ending x coordinate 

•STOPY = ending y coordinate 

;DIRECTIONX = 00H = FORWARD MOVE: IF <> 00H THEN BACKWARD MOVE 
;DIRECTIONY = 00H = MOVE UP : IF <> 00H THEN MOVE DOWN. 

;****♦*******************♦*♦************************************** 

;Define a macro to be used in this routine to erase an object (line) 

;on the screen. 
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Listing 9-1 continued 


;***************************************************************** 


ERASE MACRO 

STORTPX,STOPPX,STfiRTPY,STOPPY, COLORP 

MOV 

STftRTX, STORTPX 

MOV 

STOPX,STOPPX 

MOV 

STfiRTY, STARTPY 

MOV 

STOPY,STOPPY 

MOV 

COLOR,COLORP 

CALL 

DRAW LINE 

ENDM 

****************************************************************** 

MY STACK 

SEGMENT PARA STACK ’STACK’ 

DW 

100 DUP(?) 

MY STACK 

ENDS 


;**************************************************************** 
MY^DATA SEGMENT PARA ’DATA’ 

STARTX DW 

STOPX DW 
STARTY DW 
STOPY DW 
DIRECTIONX 
DIRECTIONY 
D L FLAG 


COLOR 

MY^DATA ENDS 

• ******************************************************************** 
;ThB color combinations in this exarnDle are white on black, and 
; black on black due to using the high res. mode of ooeration. 

5 you can specify other color combinations if using the 
;medium resolution mode. See the text for an explanation of the 
;possible modes of operation. 

5******************************************************************** 

W^B EQU 07H ;White on black 

B_B EQU 00H ;Black on black 

;******************************************************************** 
;The main procedure is simply a test program for the 
;graphic procedure DRAW_LINE. The programmer must define the 
;start and stop positions of the X and Y axis. The coordinates 
;must be within the capabilities of the graphics mode. For 
;medium resolution displays this means an X value from 0-319, 

;and a Y value of 0-199. In high resolution mode, the X values 
;must lie in the range of 0-639, and must contain Y values 
;between 0-199. The graphic routines do not perform bounds 
;checking on the values supplied! 

5 

;This program will draw a large ’A’ on the screen and 
;create a moving border to create the effect of animation. 

MY^CODE SEGMENT PARA ’CODE’ 

ASSUME CS:MY^CODE,DS:MY^DATA,ES:MY^DATA,SS:MY^STACK 
MAIN PROG PROC FAR 


320 

470 

100 

4 

DB 

DB 

DB 


DB 


0 

0 

0 


START at center screen 
use high res mode, 
stop point. 

Start of y = center screen 
Go UP. 

Initialze direction as fwd- 
and UP. 

flag for reachinn the end 
of X and Y. Bit 0 = 1 = 
end of X reached. 

Bit 1 = 1 then end of Y 
Reached. 

Used to specify the color 
attribute of the dot. 
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STPRT: 

PUSH 

DS 


;Save code segment 


XOR 

AX, AX 


;Zero offset return 


PUSH 

AX 


;Save offset 


MOV 

AX,MY_DATA 


;Set upsegment registers 


MOV 

DS, AX 




MOV 

ES, AX 



******* 

Get the 

current video mode 

, save it, and establish the 

• ****** 

new video mode. For 

this example, use mode S? the high 

• ****** 

reso1ution mode. 




eVDMODERD 


:Get the current status 


PUSH 

AX 


;Save the video mode 





;which was returned in AL 


MOV 

CX,40 


;Do the procedure 40 times. 


©VDMODE 

6 


;Set high res mode. 

;****** 

Start of the test proorarn 

****************************** 

• ****** 

Draw the letter ’A’ 

on the 

screen ********************** 

DRftW_IT! 

MOV 

STARTX,320 


5 Set parameters to draw 


MOV 

STOPX,470 


; End po i nt 


MOV 

STARTY,50 


;Now define Y axis 


MOV 

STOPY,150 




MOV 

COLOR,W B 


;White on black 


CALL 

DRAW LINE 


;Go draw the line defined. 

DRfiW IT2: MOV 

STARTX, 320 


;Define next line- 


MOV 

STOPX, 170 




MOV 

STARTY, 50 


;Define Y axis 


MOV 

STOPY,150 




MOV 

COLOR,W^B 




CALL 

DRAW^LINE 




CALL 

DELAY 


;Delay a while 

DRAW IT3: MOV 

STARTX,275 


;Horizontal line 


MOV 

STOPX,375 


;Bar foY' the ’A’. 


MOV 

STARTY,100 




MOV 

STOPY,100 




MOV 

COLOR, W B 


;WHITE ON BLACK 


CALL 

DRAW LINE 


:Draw it. 


CALL 

DELAY 


5 Delay awhile 


CALL 

DELAY 



******** Now draw a border around 

the letter. After a snort delay. 

******** erase 

the line, ana 

redraw the shape elsewhere on the screen. 

;ThiB is known 

as animation. 



DRfiW_2: 

MOV 

STARTX, 0 


;Draw a straight line 


MOV 

STOPX,540 


■ 

* 


MOV 

STARTY, 199 


• 


MOV 

STOPY,199 


• 

n 


MOV 

COLOR,W B 


m 

n 


CALL 

DRAW LINE 


;Draw the line- 


CALL 

DELAY 


;Wait awhile 


ERASE 

0,540, 199, 199, B B 

5 Erase the line. 


CALL 

DELAY 


;delay a bit. 

DRAWLS: 

MOV 

STARTX,540 


;draw a new line 


MOV 

STOPX,540 


;from bottom up on right of screen 


MOV 

STARTY,199 




MOV 

STOPY,0 




MOV 

COLOR,W B 


;White on black 


CALL 

DRAW LINE 


;dY'aw the line 


CALL 

DELAY 


;delay awhile 


ERASE 

540,540, 199, 

0, B__B 

sand erase the line. 
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Listing 9-1 continued 


DRAW 


CALL 

DELAY 

MOM 

STARTX,540 

MOM 

STOPX,0 

MOM 

STARTY,0 

MOM 

STOPY,0 

MOM 

COLOR,W B 

CALL 

DRAW LINE 

CALL 

DELAY 

ERASE 

540, 0,0,0, B B 

CALL 

DELAY 

MOM 

STARTX,1 

MOM 

STOPX,1 

MOM 

STARTY,0 

MOM 

STOPY,199 

MOM 

COLOR,W B 

CALL 

DRAW LINE 

CALL 

DELAY 

ERASE 

1, 1,0, 199, B B 

CALL 

DELAY 

DEC 

CX 

JNZ 

DRAW^IT^ISLAND 

eWAITKEY 

POP 

BX 

C-MDMODE 

RET 

BL 

ISLAND: 

JMP DRAWEE 


MAIN PROG ENDP 


;Draw line from too right 
•to too left of screen 


:Now erase it. 

:draw line from too to bottom on ief 
;of the screen 


;And erase this line. 


; Decrement count er 

;Jumo to the ’jumo’ island. 

;Wait for a key closure before 
;ending. 

;Restore old video mode 

;01d mode is in BL 

;A11 done - return to MSDOS 

;This is an island jumo ooint 
:to jurno to the start of orograrn. 
:see the text for an explanation 
5of why islands are sometimes 
;needed. 


;****************************************************************** 
;This is the line drawing routine which will draw a line on the 
;selected graphics screen by setting a range of dots specified 
5 by start and stop, X and Y values. The routine automatically 
?determines if the dots must be drawn in a forward or reverse, 

;or down or up direction. Simply supply the start and stop 
;X and Y values in the Rm locations, STARTX, STOPX, STPRTY, and STOPY. 
;The routine also needs scratch oad RAM for DIRECTIONX, DIRECTIONY, 
sand storage for a flag byte D_L_FLPG which is used for X, Y 
; graphic control. 


DRAW LINE 

PROC NEAR 


PUSH 

CX 

:Save count. 

MOM 

AX,STOPX 

^Calculate direction 

SUB 

AX,STARTX 

;If no carry then move forward 

JNC 

FORWARDX 


MOM 

DIRECTIONX,01 

;Direct ion = 01 = backwards 

JMP 

SHORT D_L_E 

;And continue past next part 
;of code- 

FORWARDX: MOM 

DIRECTIONX,0H 

5 

D^L^E: MOM 

AX,STOPY 

;Calculate direction of Y 

5 (up or down) 

SUB 

AX,STARTY 

illF STOP > START THEN MOME 
sDOWN 
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JNC 

DOWNY 



MO^ 

DIRECTIDNY,0H 

;Move down 


Jjv!P 

SHORT D L 3 

:AND CONTINUE 

DOv^lNY: 

MOV 

DIRECTIONY,01H 

;01 means move down. 


@SET 

STARTY,STARTX, COLOR 

;ROW, COLUMN AND COLOR 


CMP 

D^L„FLAG,03H 

sSee if bit 0 and 1 set 


J£ 

D L 4 

;If set, exit 


MOV 

AX,STARTX 

sCornoare to end 


CMP 

AX,STOPX 

;If eouai set flag 


JNE 

D L 5 

;If not, then skio. 


OR 

D L FLAG,01H 

:Set the flan 


JMP 

SHORT B £ 

;Go check Y 


CMP 

DIRECTIONX,00H 

;Which way are we goino? 


JNE 

BACKWARD 1 

;Dnaw backwards 


INC 

STARTX 

5 i ncrernent co 1 urnn 


Jt*\o 

SHORT B £ 

;AND CONTINUE 

BACKWARD 1: DEC 

STARTX 

; Decrement co 1 urnn 


MOV 

AX,STARTY 

;are we at the end of rows? 


CMP 

AX,STOPY 



JNE 

D L 6 

;If not do not set flag. 


OR 

D L FLAG,0£H 

•Set bit £ 


JMP 

SHORT U £ 

;SkiD inc. or dec. of Y 

I>_k>.6s 

CMP 

DIRECTIONY,00H 

5 Which way for Y? 

;00H means uo. 


JZ 

UP 1 



INC 

STARTY 

;Increment row 


JMP 

SHORT U__£ 

;AND CONTINUE 

UP,_i : 

DEC 

STARTY 

?Decrement Y position 

U^£: 

JMP 

D.^L_^3 

:Repeat operation 


MOV 

DIRECTIONX,00 

;Reset routine directives 


MOV 

DIRECTIONY,00 



MOV 

D L FLAG, 0 



POP 

CX 

;Retrieve count. 


RE’: 


;£xit procedure 


DRAg_LINE ENDP 

;********************************************************** 


5 This 

routine 

cenerates 

a fixed delay. 


DELAY 

PROC 

NEAR 




PUSH 

CX 

;Save reaister 



MOV 

CX,50 

?COUNT ='50 for delay 

loop. 

DELAY_ 

LOOP: 

LOOP 

DELAY_L06p ;Approx delay = 50 

* .01 Sec. = l/£ sec 


POP 

CX 

;Restore register 



RET 




DELAY 

ENDP 




• ******************************************************************* 
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Listing 9-2 
SOUND.ASM 


PftGE 60,132 

TITLE SOUND GENERATION 

SUBTTL A SOUND PROGRAM 

.XLIST 

INCLUDE B:DOSEQU.EQU 


IFl 

INCLUDE B:MACFLE-MAC 
END IF 

*********************************************************** 

; So und Proced ure 
;Created: 06-14-84 
;By: Gary A. Shade 
;Last Revised: 08-12-84 

; (c) 1984 Gary A. Shade. All Rights Reserved 

5 

5 

5 This program will produce a soecified tone, of a soecified 
;duration from the IBM PC’s internal soeaker. 

5 It must directly address the 8255A which is the interface chio 
;that controls the soeaker. Bits 0, and 1 of the Programmable 
•Peripheral Interface (PPI), turn the soeaker on and off. 

;Bit 1 directly drives the speaker, while bit 0 gates the output 
5 of the 8253 programmable timer to the soeaker. 

;The clock inout to the timer is 1.19 MHz, and the timer provides 
;a system clock tick 18.2 times/second should you want to program 
;the 8253 timer directly. See the IBM Technical Reference Manual 
; (# 6025005) for more details. 


;The PPI is located at the following port addresses: 

•60H -> Input port used for keyboard scans 
•61H -> B0 = Speaker gate from timer 2 of 8253 
; B1 = Speaker data 

562H -> Inout used for system functions see IBM Technical 
; Reference Manual (#6025005) page 1-12 for more details. 

5 

;************************************************************* 

;Define speaker output port 
SPEAKER EQU 61H 

5 

;Define 

MY^STACK SEGMENT PARA STACK ’STACK’ 

DW 100 DUP(?) 
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MY_STfiCK ENDS 

:***********»**********************************************♦*»* 


MY DATA SEGMENT 

PARA 

’DATA’ 

FREQUENCY^TABLE 

DN 

100,3 DUP (530,662,694, 662), 3 DUP(503) 


DN 

2 DUP(694,694,694,530, 592,592) 


DUi 

2 DUP(530,662,694,662),4 DUP(530) 


DM 

2 DUP(494,494,330, 434, 492) 


DN 

00 ;END OF TABLE 

DURATION^TABLE 

DN 

15 DUP(25), 50 


DN 

4 DUP(25,25,50) 


DU 

10 DUP(25),100, 200 


DN 

10 DUP(64) 

DURATION 

DN 

0 ;Used in sound rout: 

FREQUENCY 

DN 

0 

MESSAGE! 

DB 

’Hit any key to begin SOUND! ’,’ 

MY DATA ENDS 



;************************************************************* 

MY CODE SEGMENT 

PARA 

’CODE’ 

SOUNDS PROC 

FAR 


ASSUME 

CS:MY 

CODE,DS:MY DATA,ES:MY DATA,SS:MY STACK 

BEGIN SOUND: PUSH DS 

;SAVE MSDOS RETURN SEGMENT 

XOR 

AX, AX 

;ZERO AX AND SAVE OFFSET 

PUSH 

AX 

5 

MOV 

AX, MY 

^DATA ;SET UP SEGMENT REGISTERS 

MOV 

DS, AX 


MOV 

ES, AX 


XOR 

SI,SI 

? 

XOR 

DI,DI 

;Zero pointers 


PROMPT: 


eSCRDLL 06,00,ISH, 4FH,00, 00, 07 


;PromDt user to hit any key. 
;Clear the screen 


C-VDLINE MESSAGE 1 
©WAITKEY 


;Wait for a key to be pressed. 


NEXT NOTE: 


E: MOV 

AX, FREQUENCY TABLECSn 

•Set up RAM for sound rout 

MOV 

FREQUENCY,AX 

5 

MOV 

AX,DURATION TABLECDII 

;Set duration of note 

MOV 

DURATION,AX 


CALL 

SOUND GEN 

;CALL THE SOUND GENERATOR 

INC 

SI 

;Point to the next entry 

INC 

SI 


INC 

DI 

5 

INC 

DI 


CMP 

FREQUENCY^TABLE CSI3,00H 

5 If 00 encountered, then 
;the value is a stop code 

JNE 

NEXT^NOTE 

;Play another note. 

RET 



ENDP 


;End of main procedure 


Sound generator procedure. Must have the memory locations 
sound, and frequency set with the proper values before 
calling this procedure. All registers are saved on entry, and 
restored on exit from this routine. 


SOUND GEN 


PROC 


NEAR 
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Listing 9-2 continued 


PUSH 

AX 

;Save registers 

PUSH 

BX 

PUSH 

CX 


PUSH 

DX 


MOV 

BX,DURATION 

;Set UD duration value 

IN 

AL,SPEAKER 

;Get current value and 
;save it for later. 

PUSH 

AX 

5 

CL I 


;Disable interruots 

GENERATE: 

AND AL,0FCH 

;Reset bit 1 & 0 of PPI 

OUT 

SPEAKER, AL 


GEN COUNT: MOV 

CX,FREQUENCY 

:Defines inner loop count 

FREQ OUT: 

LOOP FREQ OUT 

; Inner delay loop * 10 rns 

OR 

AL,03H 

;Turn speaker off. 

OUT 

SPEAKER, AL 


MOV 

CX,FREQUENCY 

;Keep it off for a while 

FREQ^OUT^E: 

LOOP FREQ^OUT^E 

;Loop value 10 ms. 

DEC 

BX 

;Decrement outer loop count 

JNZ 

GENERATE 

;If not done, repeat seauence 

POP 

AX 

;Get old value of the port 

OUT 

SPEAKER,AL 

;Restore original port values 

ST I 


5 Restore interrupts 

POP 

DX 

;Restore registers 

POP 

CX 


POP 

BX 


POP 

AX 


RET 


;Return to caller 

SOUND GEN 

ENDP 

;End of this procedure 


MY CODE ENDS 


;End of segment 

END 

BEGIN^SOUND 

;Define program entry point 
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Listing 10-1 
DLOAD.ASM 


60, 132 

TITLE DLQAD.ASM 

SUBTTL FILE DOUiNLOAD EXAMPLE 

.XLIST 

INCLUDE B:DOSEQU. EQU 
.list 

IFl 

INCLUDE B:MACFLE.MAC 
END IF 

- ************************************************************ 

;Fiie download examDle 
;By: Gary A. Shade 
;Date: 07-10-84 
5 Last Uodated: 03-07-85 
; (c) All riphts reserved. 

5 This oroprarn will seouentially read a text file fY-orn disk. 

:This oropram will work with MSDOS £.0. 
sit is to be used in coniunction with 

sthe telecommunications oroprarn modules COMM. ASM. The orocrarn 
smodule here routes all disk outout to the TX BUFFER defined in 
sthe telecorn module. 

sSee the external list for a list of the labels and rnessapes whicn 
srnust be defined int he telecommunications module as PUBLIC. 

sThe orocedure tey^minates when an end of file character is 
Rencountered (HEX lAH) when readinp from the disk file. 


EXTRN DISK BUFFER^SsBYTE, TX_BUFFER IN:WORD, TX..BUFFER^.OUTsWORD 
EXTRN TX^CHARS s BYTE.TX.BUFFER:BYTE 

EXTRN SYSTEM STATUS..SsBYTE, FILE.HANDLE.SsWORD, MESSAGEl7sBYTE 

EXTRN MESSAGES© s BYTE,MESSAGE42 s BYTE 

EXTRN MESSAGE41SBYTE.MAX CHARSsBYTE 

EXTRN KBUFFERs BYTE.CHARS.TYPED s BYTE 

EXTRN KBDBUFFERsBYTE.MESSAGES©sBYTE 

EXTRN MESSAGE45 s BYTE,MESSAGE46s BYTE, MESSAGE44 s BYTE 

EXTRN MESSAGE475BYTE 


PUBLIC START..TX..FILE 
MY.C0DE SEGMENT PARA PUBLIC ’CODE’ 
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Listing 10-1 continued 

STPRT TX FILE PROC FAR 
ASSUME CS:MY,CODE 


START_1: 

TEST SYSTEM__STATUS_^S, 10000000B 5 See if send bit 

;already set. 

:Skio file name fetch 
sand ooen routine if it 
; is. 

JZ START £ 

JMP READ FILE 


START,£s 

MOV TX BUFFER IN,0 sReset tx buffer oointers 

MOV Tx" buffer"OUT, 0 s 

MOV TX CHARS, 0 


©SCROLL 06,00, 18H,4FH, 00, 00,07 

©vdline message17 

©CRLF 

MOV MAX,.CHARS, 40D 


GET.NAME: 

0KBDLINE KBUFFER 


sClear the screen 
sAsk for the filename 
sGo to the next line. 

515 Characters maximum 
;as in BsTESTFILE.TXT<CR> 

sGet the filename. 


XOR BH,BH 


MOV BL,CHARS„TYPED 

MOV KBDBUFFERCBX3,00H 

©OPEN FILE 2 KBDBUFFER,00H 

JNC G..N_2 

JMP OPEN,ERROR 

G.^N_2s 

MOV FILE.HANDLERS,AX 


;Zero hinh order of BX 
sregister since the 
soffset to the first char 
styoed is zero. 

5Terminate ASCII filename 
;with a zero (NUL) byte. 
sMacro call to ooen file 
sSkiD if no errors 
sif the carry is set then 
5 File ooen error 

sSave the file handle 


SET..UP s 

©SET...DTA DISK..BUFFER._S sSet the Disk transfer 

5 address 

OR SYSTEM ..STATUSES, 10000000B sSet high bit to 

;indicate file ooen for 
;reading. 


READ„RECORD: 


©CRLF 

©VDLINE MESSAGE20 

READ.FILE: 

MOV DL,0FFH 

©CON_IO 
JZ R F 0 


;File ooen message 


:See if a character is 
5 ready 

:Z flag set if char, not 
5 ready 
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JMP 

EOF..FOUND 

:fc.lse abort if a key was 
;Dressed 


CMP 

TX CHARS,0 

:Are all chars transmitted 


JZ 




JMP 

EXIT,__£ 

:If not then return 
:without reading- 

R^F^l: 





©READ FILE 2 FILE_HANDLE__S, DISK. 

.BUFFER ..S- 255D 


JC 

READ_ERROR 

:If carry set then a 
:read error 


CMP 

AX,00H 

:If zero then EOF 


JNZ 

CONTINUE 

:Else continue 


JMP 

EOF.. FOUND 


REPD ERROR: 




CMP 

AL,05H 

;If AL = 05 then 
:ACCESS DENIED 


JNZ 

CHK._HANDLE 

:Take action. 

PCCESS. 

DENIED: 




C-CRLF 


:New 1ine 


©VDLINE 

C-CRLF 

MESSAGE45 

:Access denied 


JMP 

SHORT CONT...ERROR 


CHK^HPNDLE: 




CMP 

AL,06H 

:If AL = 06 then 
;invalid file handle 


JNZ 

CONT„ERROR 

:If not then continue 


©CRLF 

©VDLINE 

MESSAGE41 

:Invalid handle 


C-CRLF 

CONT ERROR: 




JMP 

EOF...FOUND 


CONTINUE: 





MOV 

CX, AX 

:Number of bytes to move 

C_ 

.1: 






LEA 

SI,DISK....BUFFER..S 

:Move from disk buffer to 





;transmit buffer. 



LEA 

DI,TX...BUFFER 




CLD 


:Set for auto inc. 

C... 

.2: 






REP 

MOVSB 




MOV 

TX^CHARS,AL 

:Set the number of 





:characters in the buffer 



MOV 

TX BUFFER IN,0 

:Zero oointers 



MOV 

TX BUFFER OUT,0 




JMP 

EXIT 2 



OPEN ERROR: 

CMP AX,02H 

JNZ 0_E__1 

eCRLF 

eVDLINE MESSAGE42 
eCRLF 

JMP EXIT £ 


:File not found? 
:NO? Then continue 
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Listing 10-1 continued 


CMP 

AX.04H 

JNZ 


@CRLF 

0VDLINE 

MESSAGE44 

@CRLF 

JMP 

EXIT^.2 

CMP 

AX,05H 

JNZ 


C-CRLF 

©VDLINE 

MESSAGE45 

C-CRLF 

JMP 

EXIT^2 

CMP 

AX,12H 

JNZ 

0^E_4 

eCRLF 

0VDLINE 

MESSAGE4& 

@CRLF 

JMP EXIT^E 

C-CRLF 

C-VDLINE 

MESSAGE47 

©CRLF 

JMP 

EXIT 2 


:Too many ooen files 


;Access denied 


;Invalid access code? 
;Else undefined error 


5 Undefined error trao- 


EOF FOUND: 

eCRLF 

©VDLINE MESSAGE42 :DisDlay end of oroorarn 

:me5saQe. 

©CRLF 

AND SYSTEM^STATUS^S,0011iniB ; Reset bit 7 & 6 to 

;show that 
5 transmissions are 
;inactive. 

MOV TX_BUFFER_IN, 0 ;Zero buffer pointers 

MOV TX BUFFER^OUT,0 

MOV TX^CHARS,0 


EXIT: 

C-CL0SE.^FILE_2 FILE^HANDLE^S 


;Close the file. 


EXIT 2: 

RET 

START_TX_FILE ENDP :End of this procedure 


MY CODE ENDS 

END START^TX^FILE 
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Listing 10>2 
COMM.ASM 


PAGE 60,132 

TITLE CoMunicat ions prograi 
SUBTTL By: Gary A. Shade 

.XLIST 

INCLUDE B:DOSEQU.EQU 
.LIST 

IFl 

INCLUDE B:HACFL£.HAC 
0IDIF 

•ttmmmmmmmtmmmmtmmtmmmmtmmt 

;Coeaunicat ions Nodule 
.'Created 08*03-84 
.:By: Gary A. Shade 

MC) 1984 By Gary A. Shade, All rights reserved. 

:Last Revised: 2-25-85 

.'This prograe allovs autooatic buffering of incooing data to 
:disk and to the printer. It uses XON/XOFF IDCl and DC3) 
:handshake protocols for flov control. 

.'After initializing the cooouni cat ions paraoeters, the 
;prograo vill then allov the opening of a disk file via ALT - D. 
;The printer can be toggled on and off via a control-R 
;and control-T sequence. To exit the prograo use ALT - Z. 

;To see a 'help' oenu use ALT - H. 

:To transiit a file use ALT - B. 


PUBLIC DISK mm( S 
PUBLIC TX.BUFFffljii 
PUa.IC TX BUFFER.OUT 
PUBLIC TX CHARS 
PUBLIC TX.BUFFER 
PUBLIC SYSTEH.STATUS.S 
PUBLIC FILE.HANDLE.S 
PUBLIC NESSAGE17 
PUBLIC HESSAGE20 
PUBLIC IIESSA^42 
PIM.IC IIESSAGE41 





448 8088!IBM PC Assembly Language Programming 


Listing 10-2 continued 

PUBLIC NCSSAGE4S 
PUBLIC HESSAGE46 
PUBLIC NESSA^44 
PUBLIC NESSAGE47 
PUBLIC KBUFFER 
PUBLIC mjcms 
PUBLIC CHARS^TYPED 
PUBLIC KBDBU^ 


EXTWI STARTJX,FIl£;FAR 


;Thi 5 proQrat aodule vill allow the user to configure the 
;coneunicat ions channel (serial I/O), as to baud rate, parity, 
;and other paraneters. 

;To set the coenunicat ions paraeeters set AL to the desired 
;bit pattern as follows: 

;b7 b6 b5 b4 b3 b2 bl bO 


’> Vord length: 0 0 = 5 bits 
0 1 = b bits 
10 = 7 bits 
11=8 bits 

-> Stop bits: 0 = 1 stop bit. 

1 = 2 stop bits.I 
-> Parity : 0 0 = No parity 

0 1 = Odd 
1 0 = No Parity 
1 1 = Even 


> Baud Rate: 

0 0 0 = 110 Baud 
0 0 1 = 150 Baud 
0 1 0 = 300 Baud 
oil =600 Baud 
1 0 0 = 1200 Baud 
101= 2400 Baud 
110= 4800 Baud 
111= 9600 Baud 


;l = If 5 bit word length selected, and b2 = 1, then stop bits 
;wi11 be 1.5 per word transeitted. (BAUDOT and TTY). 

:Use BIOS interrupt 14H to set the cotounicat ions paraneters. 
;Vith AH set to function nunber 00 

;Use BIOS interrupt 14H, Function nunber 01 to transnit a 
; character. 

: - - -• - - 02 to receive a 

; character. 

:And BIOS interrupt 14H, Function nunber 03 to read the 
;connunicat ion's port status. 
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;The serial port and eodet status are returned as follows: 

:Function status is returned in AX as: 

; AH AL 

Line Status I Hodee Status 


;b7 = Ti»e out 

:b6 - Transiitter shift register eepty 

;b5 = Transiitter holding register is eipty 

;b4 = Break Detect 

;b3 = Fraiing Error 

;b2 = Parity error 

;bl = Overrun error 

;b0 = Data Ready 


Carrier detect (CD) 
Ring Indicator (RI) 
Data Set Ready (DSR) 
Clear to send (CTS) 
Delta CD 
Trailing edge RI 
Delta DSR 
Delta CTS 


•mtmmmtmxttmttmmmnmtmmmmmmmm 

^Define stack segient 

MY.STACK SEGMENT PARA STACK 'STACK' 

DV 25A DUP(?) ;25A word stack 

MY.STACK ENDS 

•Mmmtmmtmmmmmtmmmtmmmttmmmm 

•Mmmmmmttmmmttmntttmmtmmmmtmtttt 

;Define the data segaent. 


NY.DATA SEGNQIT PARA 

PUBLIC 'DATA' 

KBUFFER LABEL 

BYTE 


NAX.CHARS 

DB 

42D ;42 Characters laxii 

CHARSjyPED 

DB 

? ^Characters entered 

KBDBU^ 

DB 

42D DUP(OO) ;32 byte buffer 


:tttt Define lessages used to proipt user etc. 


NESSAGEl 

m 

'Enter the desired Baud Rate ','i' 

NESSA6E2 

DB 

'(!) = !!Q Baud 

(2) = !50 Baud ' 


DB 



)IESSAGE3 

DB 

'(3) 300 Baud 

(4) ^ m Baud ' 


DB 

'i' 


NESSAGE4 

DB 

'(5) !200 Baud 

(6) = 2400 Baud 

MESSAGES 

DB 

'(7) = 4800 Baud 

(8) = ?W0 Baud 

MESSAGED 

DB 

'Use parity? (Y/N) ', 

'1' 

MESSAGE? 

DB 

'(!) Even 

(2) Odd 

MESSAGES 

DB 

'How lany stop bits? 


MESSAGE? 

DB 

'(!) = ! Stop bit 

(2) s 2 Stop bits','!' 

NESSAGEiO 

DB 

'Nord length? ','1' 


MESSAGE!1 

DB 

'(!)7Bit5 (2) 8 Bits','!' 

MESSAGE!2 

DB 

'(5 Bit and A bit transaission are not supported) 


DB 
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Listing 10-2 continued 


MESSAGC13 

IB 

'CoAiunicat ions port has been initialized ','1' 

HESSAGE14 

DB 

'Terainal prograi for IBH PC (c) 1984 Gary Shade' 


DB 


NESSAGEiS 

OB 

'Disk error! - Closing file','$' 

NESSAGEiA 

IB 

'Printer is not selected! Print spooling is off' 


DB 

'$' 

NESSAGEl? 

DB 

'Please enter the pathnaoe for the file ','i' 

NESSAGE18 

DB 

•%%%% Printer is ON m«',0dh,0ah,'$' 

MESSAGE19 

DB 

'Cm Printer is OFF tm',0dh,0ah,'$' 

NESSAGE20 

OB 

'%%%% Disk file is now open till',0dh,0ah,'r 

NESSAQE21 

DB 

'till Disk file is now closed till',0dh,0ah,'$' 

MESSAGE30 

DB 

'Local echo all characters transeltted? (Y/N) 

NESSAGE31 

OB 

'Do a Carriage return linefeed on receipt of a CR? ' 


DB 

'(Y/N)','$' 

NESSAGE41 

DB 

'll Invalid File Handle - Returning to ter«inal »ode 


DB 

ODH,OAH,'i' 

NESSAGE42 

DB 

'End of File found - Returning to ter»inal aode ' 


DB 

ODH,OAH,'l' 

NESSAGE44 

DB 

'Too Aany files open - returning to tereinal node ' 


DB 

0DH,0AH,07H,'I' 

NESSAGE45 

DB 

'File Access Denied! ',0W1,0AH,'I' 

l!ESSAGE4A 

DB 

'Invalid access code ',ODH,OAH,'l' 

MESSAGE47 

DB 

'Undefined error code ',ODH,OAH,'$' 

HHESi 

DB 

'ALT - B = Transiit a disk file' 


DB 

ODH,OAH,'$' 

HHES2 

DB 

'ALT - D = Open disk file for spooling' 


DB 

ODH,OAH,'r 

HHES3 

DB 

'ALT - H s Display help senu' 


DB 

ODH,OAH,'$' 

HnES4 

DB 

'ALT - Z = Exit the program' 


DB 

ODH,OAH,'i' 

HMES5 

DB 

'DC1/DC3 = XON/XOFF',Odh,Oah 


DB 

'DC2/DC4 = Printer ON/OFF',0dh,0ah 


db 

'$' 

HHES6 

DB 

'ALT - A = Display directory' 


DB 

ODH,OAH,'i' 

HMES7 

DB 

'ALT - X = XMODEM file transfer' 


DB 

ODH,OAH,'i' 

HNES8 

DB 

'ALT - S • Set/Change terninal characteristics' 


DB 

ODH,OAH,'$' 

EXIT.FLAG 

DB 

00 ;Flag to signal an end to the prograo 

;lf set to 01 then return to MSDOS 

RS IN POINT 

DN 

00 Input pointer to the RS232 buffer 

RS.OUT.POINT 

DV 

00 ;0utput pointer to the RS232 buffer 

RS CHARS 

DV 

00 .:NuAber of characters in RS buffer 

pr'inter.in 

DV 

00 ;Printer buffer input pointer 

PRINTER OUT 

DN 

00 ;Printer buffer output pointer 

PRINTER^CHARS 

DB 

00 ;NuAber of characters in buffer 

DISK IN 

DV 

00 ;P0INTER INTO THE DISK BUFFER 
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TX.CHARS 

OB 

00 

.•Characters in buffer 

TX.BUFFER_OUT 

0¥ 

00 

^Buffer output pointer 

nmmjn 

DV 

00 

; Buffer input pointer 

KIN 

DB 

00 

.^Hiniiue value used in MINMAX routine. 

MM 

DB 

00 

;HaxiAUA value used by iinaax routine. 

DISK.STATUS 

DB 

00 

:If zero then we are DCl'd for disk I/O. 




;If non-zero then we have sent a DC3 to the 




; other teriinal to indicate we are near or 




:at a buffer full condition. 

SYSTEM.STATUS 

. DB 

00 

;Bit napped status as follows 

II 

o 

printer status: 

0 = printer off 

; 



1 = printer on 

bl = 

disk spooler: 

0 = off, 1 = on 


b2 = printer flow control; 0 = we are not DC3'd 

1 = we are DC3'd 

b3 = Receive DC3 status: 0 • we are not DC3'd 

1 = we are DC3'd 

b4 = receive buffer status 0 = we are not DC3'd 
1 = we are DC3'd 

b5 = self sent DC3 0 = we have not sent a DC3 

1 = we have sent a 0C3 froi the keyboard. 
b6 = local echo of characters transaitted. (True half duplex) 
if this bit - i then echo. 

b7 > newline function - on receipt of a carriage return ODH, 

do a carriage return/Iinefeed coibination. 
(Only if this bit is set. If not do CR only) 


SYSTEM^STATUS.S 

DB 

0 

;Down load status byte 

CONFICURATICW 

DB 

0 

.iConf iguration for RS-232 

FILE^HANDLE 

DV 

0 

;File handle of an open f 
:stored here. (Receive) 

FILE.HANDLE_S 

DV 

0 

;File handle of file 
;being transaitted here. 

DISK_BUFFER_S 

DB 

512 DUP(O) 

:Buffer for transnit. 


RS.BUFFER 

DB 

07FFH DUP(O) 

;RS-232 buffer 

PRINTER^BUFFER 

DB 

25A DUP(O) 

;Printer buffer 

DISK.BU^ 


512 DUP(O) 

;Disk buffer 

TX.BUFFER 

DB 

256 DUP(O) 

JTransnit buffer 

OLD.VECTOT 

DD 

0 

.‘Storage for old RS23 
;interrupt vector 
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Listing 10-2 continued 
HY.DATA 0JDS 


;Deflne equates used in this file. 


DC! 

EQU 

ilH 

;ASCII CONTROLS 

DC2 

EQU 

12H 


DC3 

EQU 

i3H 


DC4 

EQU 

14H 


SOH 

EQU 

OlH 


SECTOR 

EQU 

512 

;512 byte sectors 


SERIAL.PORT EQU 00 ;U5e serial port 1 

Dart reqisier absolute addresses. 

;THR and RHR selected for output and input if bit 7 of the 
;control register = 0. 

;THR is output and RHR is input. 


THR EQU 

03F8H 


;Transaitter Holding Register 
;for the UART 

miR EQU 

03F8H 


/‘Receiver Holding Register 

;BAUD.RATE.LSB, 

and BAUO.RATE.NSB are selected if bit 7 

;of the control 

register - 1 


;Both are output ports 



;Baud rate 

MSB 

LSB 


;50 

09H 

OOH 


;75 

OAH 

OOH 


;110 

04H 

17H 


;134.5 

03H 

59H 


;150 

03H 

OOH 


;300 

OlH 

BOH 


;600 

OOH 

OCOH 


;1200 

OOH 

60H 


;1800 

OOH 

40H 


;2000 

OOH 

03AH 


;2400 

OOH 

20H 


;3A00 

OOH 

18H 


M800 

OOH 

18H 


;7200 

OOH 

lOH 


;9A00 

OOH 

OCH 


BAUD.RATE.LSB EQU 

03F8H 

;Baud rate divisor. Selected 

BAUD.RATE.HSB 

EQU 

03F9H 

‘MSB of baud rate divisor. 

;The Interrupt eask register is selected if bit 7 of the control 

;register = 0. 

Otherwise BAUD^RATE MSB above is selected. 

;Bits 7-4 aust be lero. 



;Bit 3 - Interrupt on delta aodeo status 

;Blt 2 - Interrupt on break received, 

or recieve error 
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;Bit 1 = Interrupt when THR \s eipty. 

;Bit 0 - Interrupt on received character ready. 

;If any of the bits above are set to one, the interrupt type is enabled. 
;A zero bit oeans the interrupt type is disabled. 

INTERRUPT.ENABLE EQU 03F9H interrupt task register 

;The interrupt ID register is a read only register and contains 
;the source of the interrupt. 

;If bit 0 s 1 then there is an interrupt pending. 


Bits 1 and 2 
Bit 2 

contain the interrupt type, coded as follows! 
1 

0 

0 

Delta Nodea Status 

0 

1 

THR eapty 

1 

0 

RHR full 

i 

1 

Rx error, or break detected 

INTERRUPT.ID 

EQU 

03FAH ;Interrupt source 


The line control register specifies the paraeeters to be used 
in the coMuni cat ions channel. 

Bord Length 
bits 1 0 

0 0 5 bit word length 

0 1 A bit word length 

1 0 7 bit word length 

i i 8 bit word length 

Stop bits. 

bit 2 - 0 - one stop bit 

- 1 s two stop bits if word length » 6, 7, or 8 bits. 

one and one-half stop bits if word length is « 5 bits. 

Parity 

bit 3 - 0 - No parity {disabled) 
i s Parity enabled 

Parity type 
bit 4 = 0 = odd parity 
1 s even parity 

Force parity bit 

bit 5 - 1 • Force spacing parity (bit 3 oust - 1 and b4 ^1) 

Force earking parity (bit 3 oust - i and b4 ^0) 

Transait break 

bit 6 s 1 s Force break on TX line 
; 0 - disable break on TX line 
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;bit 7 - 1 s Access for baud rate divisor latch 
; 0 = Acess for THR and Interrupt enable register 


LINE_C0NTR0L EQU 03FBH 

;The iodeft control register is bit Mapped as follows: 

;bits 7-5 Must be a lero 

;bit 4 • 1 = Loop back, diagnostic Mode 
.:bit 3 - 1 = Auxiliary user defined output. 

;bit 2 = 1= Auxiliary user defined output. 

.!bit 1 = 1 = RTS = logic 0 ISpace = circuit on) 

; 0 = RTS = logic 1 (Hark = circuit off) 

;bit 0 = 1 = DTR = locic 0 

; 0 = DTR = logic 1 

HODEM^CONTROL EQU 03FCH 

;The line status register returns the status of the coMMunicat ions 
.'channel as depicted in the discussion earlier, about BIOS 
;call 14H which returns the status of both the ModeM and line in AX. 
;The line status port, contains only the line status as depicted 
;in the previous discussion. 

.:The ModeM status register contains only the inforeation 
;pertinent to the Modee status (also discussed previously). 

LINE.STATUS EQU 03FDH 

HODEH„STATUS EQU 03FEH 

\%%%t%%%X%%t%%%t 

;8259 INTERRUPT CONTROL PORTS. 

INT_CONTROL EQU 21H Interrupt Mask register 

INT^CONHAND EQU 20H ;CoMMand register 

•Mtxttttttntnttttttttttttnttttxnttxttxtxtttttxttntntxtntnttt 

.'Define code segeent. The procedure NAIN^PROG, is the Main prograM 
:loop used for this cooMunicat ions prograM. 

;It will set a new interrupt vector for receiver interrupts. 

:Use HSDOS function calls wherever possible and BIOS routines 
;for coMMunicat ions, and graphic control. 

HY CODE ^MENT PARA PUBLIC 'CODE' 

ASSUME CS;MY.CODE,DS:HY.DATA,ES;HY.DATA,SS;HY,STACK 

TaE..COMM PROC FAR 

START: 


PUSH 

XOR 

PUSH 


DS 

AX,AX 

AX 


;Save segMent 
.:Save returning offset 
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MOV 

AXpMY.DATA 

;Set up segeent registers 

MOV 

DS^AX 


MOV 

ES,AX 


CALL 

INIT 

initialize cooiunicat ions port 

MAIN L0(F: 



CALL 

RECEIVE 

;See if any characters in RX buffer 

CALL 

KEYBOARD 

;See if there are.any characters 
;to transiit. 

CALL 

TX RS232 

;Se if we should send any characters 

CMP 

ExiT^FLAG,01H 

;Leave the prograi? 

JZ 

EXIT 

if = 01 then leave 

CALL 

PRINTra_OUT.l 

;Send to the printer routine 

IMP 

MAIN LOOP 

;Go check tain loop. 

EXIT; 



;disable RS232 interrupts. Reset bit 3 of the eodei status register 

m 

AX,AX 


MOV 

DX,MODEM.CONTROL 

OUT 

DX,AL 





;disable RS232 interrupts via the UART interrupt enable register 

MOV 

DXelNTKRUPT.ENABLE 

OUT 

DX,AL 





;Mask coieunicat ions interrupts by writing to the 8259's interrupt 

;eask register. 



MOV 

AL,i010i000B 

;Leave disk, tiier, keyboard, 
;and graphics bd., interrupts 



;enabled. 

MOV 

DX,INT_CONTROL 


OUT 

DXeAL 


;Establish old RS232 interrupt vector before leaving. 

PUSH 

DS 

;Save vector 

MOV 

DX,¥0«) PTR OLD VECTOR ;Gei the old offset 

MOV 

Mi,mD pnf aD.VB:T0R+2 ;Sei up nev vector 

MOV 

DSpAX 

;Get old vector segsent 

MOV 

AL,0CH 

;COMM. interrupts 

MOV 

AHpF.SETJNT.VECTOR 

INT 

21H 


POP 

DS 

;Get old vector 


■tmmnm 


RET 

TlLE.COMl ENDP 

■tttmmttttttttntmttmmttttmttttttttittttutnmttmttn 

.:Thi5 procedure will transiit characters fro* the TX.BUFFER. 
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TX.RS232 

PROC NEAR 


CFP 

TX.CHARS,OOH 

;If there are no characters 
;tD transiit, exit this 
;procedure. 

JZ 

EXITJX.RS232 

; 

MOV 

DX,SERIAL.PORT 

;Get port nuiber 

RRS.STATUS 

;Get the RS232 status 

TEST 

AH,00100000B 

;ls the THR eipty? 

JZ 

EXITJX.RS232 

;If not, then leave this 
;procedure 

TEST 

SYSTEHJTATUS,00111i00B 

;See if ve are DC3'd by the 
;keyboard, printer, or receive 
;buffer full. 

JNZ 

EXITJXJS232 

;lf any are set, then exit- 
;do not send. 

MOV 

SI,TX.BUFFER.OUT 

;Get the pointer into the buffer 

MOV 

AL,BYTE PTR TX.BUFFERCSI] ;Gei the character froi 



;the buffer. 

CMP 

AL,DC3 

;Are «e sendino a DC3? 

JNZ 

GJ_0 

;No, then check for DCl 

OR 

SYSTEMJTATUS,00100000B 

.•Set bit 5 to indicate we sent 
;a DC3 froo the keyboard. 

JMP 

SHORT GO.SEND 

.tSend the DC3 

G.S..O; 



CMP 

AL,iAH 

;End of file qarbage during 
;S-record downloads. 

JNZ 

G.S.OJ 


CALL 

TX.Cli 


JMP 

EXITJXJS232 


G.S.OJ; 



CMP 

AL,DC1 

;A DCl? 

JNZ 

GO.SEND 


AND 

SYSTEM_STATUS,1101illiB 

;Reset bit 5 to clear kybd DC3 

GODSEND: 



PUSH 

AX 

;Save character 

NOV 

DX,THR 

;Transiitter holding register 
;of UART 

OUT 

DX,AL 

;Send the character 

POP 

DX 

;Retrieve character 

PUSH 

DX 


ECHO JEST; 



TEST 

SYSTEM_STATUS,01000000B 

;lf bit 6 is reset, then do not 
;echo character. 

JZ 

FW.ECHOJ 

;IFZ then skip display. 

CMP 

DL,11H ’ 


JZ 

N0_ECH0.3 


CMP 

0L,13H 






Appendix D 457 


J 2 

NO.ECHOJ 

;Do not display pacing chars< 

NO Ej; 



CHP 

DL,0DH 

;If char - CR and the 
;local echo option is on, 

;do a linefeed. 

JNZ 

NO,EJ_2 

;lf not, then skip. 

NOV 

DL, 0 ^ 




NOV 

DL,0DH 


N0_E T.2I 



CHP 

DL,0AH 

;If char = LF and local echo 



;is on, then skip. 

JZ 

NO.ECHOj 


#CHARDSP 


NO ECHO 3: 



POP 

AX 

;Retrieve character 

INC 

TX.BUFFER.OUT 

;Inc. the pointer 

AND 

TX.BUFFER.OUT,OOFFH ;Keep < = 256 bytes 

DEC 

TX^CHARS 

;Decreftent nueber of chars. 



;in the buffer. 

EXItTX,RS232; 



RET 



TX^CLR; 



NOV 

TX.CHARS,0 

;Zero pointers to buffer 

NOV 

TXJUFFERJN,0 


NOV 

TX.BUFFffl.OUTyO 


RET 



TX,RS232 

ENDP 


;This procedure will fetch a character fro* the keyboard if one is 

;ready. If one 

is not, the routine «i 11 return to the nain proqrae. 

KEYBOARD 

PROC NEAR 


TEST 

SYSTEH.STflTUS.S,llllllllB ;lf non-iero then 90 read 



;froi disk file. 

JZ 

KEY.2 

;If not set, then read keys. 

CALL 

START.TX.FILE 

;Read froe disk. 

JNP 

DONE.KEYBOAM) 

;k)NE 

KEY_2: 



MO</ 

DL,0FFH 

^Select keyboard read. 

#CON,IO 


;See if a character is ready 

JNZ 

KEYJ 


JNP 

DONE.KEYBOARD 

;If 2F • 1 then no character 

KEYJ; 



CHP 

ALrOOH 

;If 00 then EXTENDS) character 

JNE 

K.l 



CHra.EXTEND; 

#CON_IO 


;Gei the keyboard extended scan code 





458 80881IBM PC Assembly Language Programming 


Listing 10-2 continued 



CMP 

AL,48D 

;aU-b = read froe disk 


JNZ 

E.K.2 

;qo check next code 


CALL 

STAOTJX.FILE 



IMP 

OONE.KEYiOARD 


E.KJl 

CMP 

AL,32D 

;If ALT'D then enable/disable disk spool 


JNE 

MJ 

;Continue if not. 


CAU. 

TUmdmmOFF ;Go open file. 


JMP 

SHORT DCWME.KEYBQAM) ; 

ea3; 

CMP 

AL,440 

;lf alt - 1 then exit proqrai. 


INE 

E.KJ 



MOV 

EXIT_FLAG,01 

;Set flag to leave progran 


JMP 

SHORT DONE.KEYBOARD 

EKJ‘ 

CMP 

AL,35D 

;Help coeoand? 


JNE 

DONE KEYBOARD 

;If not then leave 


CAa 

HSJP 

;Otherwise display cooiands 


JMP 

SHORT DONE.KEYBOARD 


KJ; 

CMP 

AL,DC1 

;Send a DCi? 


JNZ 

K,0 

;Go if not. 


TEST 

SYSTO!.STATUS,00100000B ;Are we DC3'd? 


JZ 

K.O 

;If not then go to next portion of code. 


MOV 

DX,THR 

;Transiit the control 


OUT 

DX,AL 

;Send it. 


AND 

SYSTQI.STATUS^ilOilillB ;Reset the keyboard DC3 flag bit 


JMP 

DONE.KEYBOARD 

;Do not put into buffer. 

KJ; 





CMP 

AL,DC2 

;Turn printer on? 


JNZ 

KJ 

;If not then continue. 


CALL 

PRINTER JN 

;Go turn the printer on. 




;Send this character to the com buffer. 


JMP 

DC»IE.KEYBOARD 

;Do not store character in TX buffer 

KJ; 





CMP 

AL,DC4 

;See if DC4 = turn printer off 


JNZ 

KJ 



CALL 

PRINTS?_OFF ;Go turn the printer off. 


JMP 

DONE_KEYBOARD ;Do not store in buffer 

KJ'. 




STUFF.BUFTER: 




NOV 

SIJXJUFFffiJN 

;Put the characxter in AL into 




;the transiit buffer. 


NOV 

TX^BUITERCSn,AL ; 


INC 

TX_BUFFER IN 

Jlncreoent the pointer 


AND 

TXJUFFER^IN,OOmi ;Keep the buffer circular 
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INC 

TX CHARS :and nuiber of characters in the buffer. 

HOV 

DL,AL :See if 

we need to put the character 


!\n the print buffer or disk buffer 

TEST 

SYSTEM.STATUS,01000000B 

;If no echo, then skip 

JZ 

DONE.K^ARD ;Skip if 

no echo. 

CALL 

PRINTER JNJ 


CALL 

DISK,IN. 1 


ix»ie_keyboard; 



RET 



HELP: 



eSOTOLL 06,00,18H,4ra,00,00,07 
eVDLINE HHESl 

;Display help aessages-*ALT B 

8 VDLINE HHES2 

;ALT-D 

eVDLINE HI1ES3 

;ALT-H 

eVDLINE HHES4 

;ALT-2 

eVDLINE HHKS 

:DC1,DC2,DC3,DC4 

RET 



KEYBOARD 

ENDP 


imnmtmttmmnmmtmttnttmnttmmmtmttttmtn 

;This routine 

will set the printer status to on for printer spooling 

PRINTER ON 

PROC NEAR 


PUSH 

AX 

;Save character 

OR 

SYSTS!.STATUS,0000000iB 

.:Set bO to i to indicate 
:the printer is on. 

eCRLF 



fmiNE HESSAGE18 

:Display printer on lessage 

POP 

AX 


RET 



PRINTER ON 

0IDP 


‘.mttmmtmmtmmmmmntmmmmtmmtmmmtt 

PRINTER^OFF 

PROC NEAR 


PUSH 

AX 

;Save character 

AND 

SYSTEM,STATUS,OFSI 

;Reset systea status 

#CRLF 



8VILINE nESSA6E19 

;Show printer Is off 

POP 

AX 

;Restore character 

RET 


;Bit 0 to indicate the printer 
;spooling is off. 

PRINTER OFF 

ENDP 



ittmmtmmttttmtmtttmmtttmmmntmmttmmm 

;Thl 5 procedure will toggle the disk spooling feature. 

;If the procedure is off, it will ask for the file nate, and 
.;open a buffer for character routing to disk. 

;If the feature has already been selected, the procedure will 
;turn the spooling feature off, and close the file. 

;Assuees a file handle to be stored in aeiory location 
; TILE_HANDLE'. 
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TURN.DISK.ON.OFF TOOC 

NEAR 

TEST 

SYSTEM STATUS,OOOOOOiOB ;If bi » 1 then disk is on 



;so turn it off and close file. 

JZ 

TDISKJ 

;Zero? then turn it on. 

iHP 

TURN.DISK.OFF 

;Go turn the disk off. 

TDISKJ: 



HOV 

0L,0C3 

;Send a DCS to the other teroinal 
;suspend cooounicat ions for a iooent. 

«CRLF 


;Go to the next line 

#VDLINE HESSAGE17 

•Ask for the filenaoe 

^KBDLINE KBUFFER 

;Get the pathnaoe. 

XOR 

BH,BH 

;Zero hiqh order half of BX register. 

MOV 

BL,CHARS,TYPED 

^Offset to last char typed 

NOV 

KBOBUFFER[BX],OOH ;Tereinate with a zero 

LEA 

DX,KBDBUFFER 

;Point to file naee 

MOV 

CX,OOH 

;Read write access 

NOV 

AH,F_CREATE.FILE 2 

INT 

21H 


JNC 

GOOO.OP0I1NG 

;No carry oeans file open and 
;AX holds the file handle. 




BVILINE HESSAGE15 

.'Display error lessage. 

#CRLF 



JMP 

DONE.DISK 

^All done 

GOOD.OP0ilNG: 



NOV 

PILE.HANDLE.AX 

;Save the file handle 


#SET.DTA DISK,BUFFER ;Set the DTA 

OR SYSTQf.STATUS,00000010B ;Set status to disk on. 

eCRLF 

«VDLINE HESSAGC20 .:Shov the file is open 
JHP DONE.DISK 

TURN.DISK^OFF; 

A^ SySTEN.STATUS^llllUOlB ;Reset bi to indicate disk 

;spoo1inQ is off. 

#VDLINE NESSAGE21 ;Display file closed aessaqe 


I£A 

DX,DISK.BUFF0? 

.‘Write reiaining buffer 
;to disk. 

NOV 

CX,DISK.IN 

;Nueber of characters to write. 

NOV 

BX,FILE.HANDLE 

;Get the file handle 

MOV 

AH,F NRITE FILE 2 

;NSDOS function code 

INT 

2iH 

;NSDOS function interrupt. 


BCLOSE.FILEJ FILE.HANDLE ;Close the file 


JNC 

DONE.DISK 

;Go if no errors 

WVDLINE NESTIS 

.‘Display error oessage. 

DONE DISK; 



LEA 

SI,KBDBUFFQ? 

;Point to the keyboard buffer 

MOV 

CX,32 

.‘Clear the pathnaae fora the buffer 
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CLEAR KBUFFER: 

MOV BYTE m [SI3,0 ;Clear the buffer 

INC SI ;Point to next location to clear 

LOOP CLEAR.KBUFF0? 

RET 

TURN,DISK.0N.0FF ENDP 

itnitmhmmmmmmmttmmmmmmtmmmmtm 

;Thi& procedure is the recive handler. It will process characters 
;received frot RS-232 interrupts uhich were placed in the I^-BUFFER. 
;The procedure is executed at task tioe and not at interrupt tiae. 


RECEIVE PROC 

NEAR 



CMP 

RS.CHARS,00 

Mf RS.CHARS = 0 then return, there 



;are no characters in the buffer 

JNE 

GET.BUFF.CHAR 

;Exit i1 

zero 

JHP 

DONE.RECEIVE 



GET BUFF CHAR; 




iiov 

Sl.RS.OUT.POIHT ;Poinl to the next character to 



;reeove 


MOV 

DL,RS,BUFFERESI3 

;Get the character 

AND 

DLrOilliniB 

;Reset bit 8 - display only ASCII 

Q¥P 

DL^IAH 


;Is it an ASCII sub? 

JNZ 

GJ.2 


.:lf not then continue 

NOV 

DL,'?' 


;Use ? character 




;to signify an error 

IMP 

SHORT DSP.CHAR 

;Go display the character 





CMP 

DL,20H 


;Control or character? 

JAE 

DSP.CHAR 


;Character then go display it. 

CMP 

DL,0DH 


;Carriage return? 

JZ 

CfflJ 


;0o a carriage return linefeed 

CMP 

IL,07H 


;BELL? 

JZ 

DSP.CHAR 


;Go display 

CMP 

DL,08H 


;BACKSPACE? 

JZ 

DSP.CHAR 



CMP 

IL,09H 


;TAB? 

JZ 

DSP.CHAR 



CMP 

DL,0BH 


;VS?TICAL TAB? 

JZ 

DSP.CHAR 


;If S 0 i display the control 

CMP 

dlJih 


;DC1? 

JZ 

TX_TOGGLE.DCl 


;Go toggle the TX control 

CMP 

DLd3H 


;DC3? 

JZ 

TX^T0GGLE.DC3 


;Toggle the control 

JMP 

G.BJJ 


;Ignore other controls 

DSP CHAR; 




BCHAIM}^ 


;Display the character in DL 


6 B 3: 
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CALL PRINTKJN.l 

CALL DISKJN.l 


INC 

RS.CMJT.POINT 

AND 

RS OUT POINT,07FFH 

DEC 

RSJHARS 

JMP 

SHORT DONEJECEIVE 

TEST 

SYSTEN.STATUS,80H 

J2 

CR.ONLY 

NOV 

DL,OAH 

«3IARDSP 

CALL 

PRINTER JNJ 

CAa 

DISK.IN.l 

NOV 

OL,ODH 

^HARDSP 


;See if ve should place the 
^character into the printer buffer 
;See if «e should place the 
;character in the disk buffer. 


;lncreeent pointer 
;Keep circular 

;Decreient nueber of characters 
;ln the buffer. 

;And exit 

;If bit 7 is set then display 
;new line. 

;If not, then display only the CH 
;0o a LINEFEED (OA HEX) 

^Display it. 

;See if we should place the 
;character into the printer buffer 
;See if we should place the 

;Now the carriage return 


IMP 

TX.TOGCLE_DCi: 
AND 

JHP 

TX JOGGLE DC3: 
OR 

IMP 

D(MiE.RECEIVE; 

RET 

RKEIVE ENDP 


SHORT G_B^3 ;Increient pointers 

SYSTEHJTATUS,111101ilB ;Re5et bit 3 to reflect 
.^receiving a DCl 

SHORT GJJJ 

SYSTEMJTATUS,00001000B ;Set bit 3 to reflect receiving 
.!DC3 


SHORT GJ_3J 


mttnntttttuxxttttttttxnnttntnnttttttttxtnttttmnttmttt 

;Thi5 procedure will place the character in DL into the printer buffer 
;if the printer is enabled. 


PRINTH?.IN_1 

raOC NEAR 

PUSH 

SI 

PUSH 

DX 

PU^ 

AX 

TKT 

SYSTEM JTATUS,01H 

JZ 

EXITJRINTQ? IN 

NOV 

SI,PRINT0?.IN 

NOV 

PRINTER JUFFERCSI3,DL 

INC 

PRINTER JN 

AND 

PRINTER JN,OOFFH 


;Save SI 
;Save DX 

;See if the printer is on 

;If not, then exit this procedure. 

;Get the pointer 

;Put character in the printer buffer 
;Inc pointer 
;Keep circular 





Appendix D 463 


INC 

PRINTro.CHARS 

;Active chars in buffer increeented. 

CHP 

PRINTER_CHARS,200 

;If chars > 200 then halt until 
;buffer clears 

JBE 

EXIT^PRINTER.IN 

.:If not see exit the routine 

MOV 

AL,DC3 

;Send a DC3 to halt transeissions 

MOV 

DXJHR 

.!Send the control 

OUT 

DX,AL 


OR 

SYSTO! STATUS,04H 

;Set bit 2, to show printer DC3'd 

EXIT^PRINTERJN; 


POP 

AX 


POP 

OX 

;Retrieve registers 

I^P 

SI 


RET 



PRINTER IN 1 

m? 


•mtmmmttmmmmnmmmttmmttntnmunntn 
;Thi 5 procedure will place the character in DL into the disk buffer 

; if the buffer 

is opened. If not, 

the routine is terminated. 

;The routine will perfori a write to disk if the character count 
;in the buffer equals one 512 byte sector. 

;If there is an 
;the file. 

error, the routine 

will report such, and close 

DISK INJ 

PROC NEAR 


PUSH 

SI 

.:Save registers 

PUSH 

AX 


PUSH 

DX 


PUSH 

BX 


MOV 

BX,THR 

;Use as port address 
;to send character to when 
;pacing is required. 

TEST 

SYSTEM,STATUS,02H 

;See if bit 2 is set 
‘if non-iero result, then 
;disk spooling is on 

JZ 

EXIT,DISK_1 

;Leave routine 

CMP 

m.,20H 

;If less than 20H, do not 
:sehd to disk buffer 

JAE 

GOTO_DISK 

tlf > = to 20H then skip 
.!control character check. 

CHECK.CONTROLS: 


CMP 

DL,0AH 

; 

J2 

GOTO.DISK 

tSend to disk 

CMP 

DL.ODH 

;CR is ok to send to disk 

JZ 

GOTO.DISK 

‘ 

CMP 

DL,06H 

Backspace is ok. 

JZ 

GOTO.DISK 

; 

JMP 

EXITiDiat.l 

;Any other controls are tossed. 

GOTO DISK; 



CMP 

DISK.IN,SECTOR-10 

;Start pacing if near end of buffer 
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JB 

CONT^DISK IN 

XCHG 

OX,BX 


NOV 

AL,0C3 

OUT 

DX,AL 

INC 

DISK.STATUS 

XCHG 

DX^BX 

CONT_DISKJN; 


NOV 

SI,DISK JN 

NOV 

DISK BU^CSn,DL 

INC 

DISKJN 

CNP 

DISK JN,SECTOR 


IZ 

DISK.IffilTE 

JNP 

»K)RT EXIT DISK : 

DiaWiTE: 

PUSH 

OX 

PUffl 

cx 

PUSH 

AX 

PUSH 

BX 

LEA 

DX,DISK_BUFFER 

NOV 

CX,SECTOR 

NOV 

AH,F,WRITE/ILE.2 

NOV 

BX,FiLE^HAibLE 

INT 

2iH 

POP 

BX 

POP 

AX 

POP 

CX 

POP 

DX 

INC 

WRITE DONE 

DISK.EfSK^; 

RVDLINE 

NESSAGE15 

eCLOffi FILE.2 FILE.WmE 

AND 

SYSTQ!.STATUS,OFDH 

VRITE.DONE: 


NOV 

DISKJN,0 

EXIT.DISKJ; 


CNP 

DISK.STATUS,OOH 

JZ 

DISK.EXITJ 

S0ID.DC1; 

mQ 

DX,BX 

NOV 

AL,OCi 

OUT 

DX,AL 

XCHG 

DX,BX 

NOV 

DISK_STATUS,OOH 

DISK.EXIT.2; 

POP 

BX 


;keep going oihervise 
;Transiliter port address to 
;DX, and save character in BL 

;Send control character 
;Control sent to other teriinal 
;Non’zero byte eeans DC3'd 
;Retrieve character 

;G^t pointer into buffer 
;§ave character in buffer 
;Increient the nuiber of characters 
;intheDTA 

;If the characters in buffer are 
512 then it is tiee to 
;«rite a sector to disk. 

;Leave routine if the nueber is below 


;Save registers 


;Sei up registers for disk write. 
;512^BYTES TO WRITE 
;NSDOS function code 
.:File handle of open file 
;MSDOS function interrupt 
^Retrieve registers 


;The write has been perforied 

^Display disk write error 
;Cldse the file. 

;Reset bit 1 to show disk 
;access is off. 

;Reset pointer 

;If zero then leave 


;Get the port address 
;for the transeitter 
;Send the control char. 
;Restore character 
;Clear eeeory 
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POP DX 

POP AX 

POP SI ;Restore registers 

RET 

01^ IN 1 ENDP 

ittmmmtmmmmmttttmimmmmtmmmtttmttm 

;This routine vill reiove a character froi the printer buffer 
;and send it to the printer if the printer option is enabled. 

;This routine uses BIOS to send a character to the printer. 

;The character to print eust be in AL. 

PRINTER^OUTJ PROC NEAR 
PUSH DX 

PUSH SI ;Save registers 

PUSH AX 

TEST SYST0! STATUS,OOOOOOOIB ;If bit 0 is a 1 then printer is on. 


JZ EXIT.PRINTS?,OUT 

NPRINTro.STATUS 

TEST AH,10000000B 

JZ EXIT.PRINTER.OUT 


OK.CONTINUE: 


CHP 

PRIHTER.CH/«S,00H 

JZ 

EXIT.PRIHTER.WIT 

HOV 

SI ,reiKT0?.(WT 

HOV 

AL.PRlNTffi.BUFFERISI] 

CHP 

AL.OOH 

JNZ 

COMT.PRT 

ePRlNTER.OUT.B 

HOV 

CX,7000H 

G.STAT: 


#PRINTER.STATUS 

TEST 

AH,BOH 

JNZ 

CONT_PRT.O 

LOOP 

G_STAT 

WMIT.PRT.O; MOV AL.OflH 

COHT.PRT: 8PR1NTER.0UT.B 

INC 

PRIHTffi.OUT 

AND 

PRIMTHJ.OUT.OOITH 

D^ 

PRINTQi.CHARS 

CHP 

PRIHTER.CHftRS.lOO 

JB 

CHK.P.DC3 

EXIT^PRINTra.OUT: 

POP 

AX 

POP 

SI 

POP 

DX 


;If bO = 0 then off, so leave 
;See if the printer is on line 
;and ready. 

;If the printer is busy then 
;skip this routine for now. 
;bit 7 s 0 = busy 
; 1 = not busy 


;Any in buffer? 

;If none in buffer, exit. 

;Get out pointer 
;Get character 
;Carriage return? 

;No? Then continue. 

;yait value if busy. 

;Nait till printer is ready. 

.!lf not ready, then loop. 

;Ok, do next character 

;nait till cx = o, and try anynay 

;Now do the linefeed 

;BIOS call to send printer 
;a character in AL. 

;Inc pointer to next character 
;Keep circular 

;Dec nuaber of characters in buff. 
;If less than 100 characters 
;go see if we are DC3'd 


;Restore registers 
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RET 



CHK^P^DC3: 



TEST 

SYSTEM^STATUS,00000100B 

;See if we t»ere 0C3'd 

J2 

EXIT.PRINTER OUT 

;No, then exit routine. 

AND 

SYSTK! STATUilllllOllB 

.‘Reset bit 2 clearing DC3 

MOV 

AL,DC1 

;Send a DCl 

NOV 

DX,THR 

; 

OUT 

DX,AL 


IMP 

EXIT.PRINTER^OUT 

;Exit this routine. 

PRINTER OUT 1 

ENDP 



;This procedure is the RS232 interrupt handler. 

;If the interrupt is due to a received character, the character is 
;read froe the RS232 and placed into a circular buffer vhich 
;«in process the received characters at task tiee, not at interrupt tioe. 
; 9 This procedure assuees that a buffer is established in the 
;current data segoent. 


RS232 INT 
RS232JNTJ; 

PROC FAR 

PUSH 

SI 

PUSH 

AX 

PUSH 

OX 

PUSH 

BX 

PUSH 

ES 

PUSH 

DS 

ASSUME 

DS:MY.DATA,ES:MY.DATA 


GBT^CHAR; 

MOV M,MY.DATA 

MOV DS,AX 

MOV ES,AX 

MOV SI,RS.IN^POINT 

GET.RS^CHAR; 

MOV DX,LINE.STATUS 

IN AL,DX 

TEST AL,00011110B 


INZ ERROR 

TEST AL,01H 

J2 EXITJNTJ 

NOV OX,RHR 

IN AL,DX 


;Get pointer into the buffer 


iCheck for any errors or a 
;break condition. 

;Get the status. 

;b4 = break 

;b3 = framing error 

;b2 = parity error 

;bl = overrun error 

;If non-iero then there is an 

terror. 

‘If bit 0 = 1 then rev. char, interrupt 
thas occurred. If bO - 0 then skip routine 


;ReceivBr port 
;Get the character 
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HOV 

RS BUFFERCSI3,AL ;Save character in buffer 

JMP 

SHORT POINT^ADJ ;Leave the interrupt routine 

ERROR: 



MOV 

DX,RHR 

;Duiiy read to reset the interrupt 

IN 

AL,DX 


MOV 

AL,1AH 

;Code for ASCII SUB (Substitute) 

MOV 

RS BUFFERCSI],AL 

. ;Save it in buffer 

POINTED J: 



INC 

RS.IN.POINT ;Increient pointer 

AND 

RS IN roiHT,07FFH ;Keep circular 

INC 

RS CHARS 

;Increment nuiber of characters 



:in the buffer 

EXIT INT: 



MOV 

DX, INTERRUPTED 

.:Get any other pending interrupts 

IN 

AL,DX 

;AND TOSS THEM! 

EXIT INTJ; 



MOV 

AL,20H 

;Send an end of interrupt to the 8259 

OUT 

INT^COMMAND,AL 


POP 

DS 


POP 

ES 


POP 

BX 


POP 

DX 

;Restore registers 

POP 

AX 


POP 

SI 


IRET 


;Return fro® the interrupt 

«CRLF 



WAITKEY 

;Get user response 

MOV 

MIN,31H 

;MiniftUi value is M' 

MOV 

W«,39H 

;Naxi®ui value allowed = '9' 

CALL 

MINMAX 

;Check bounds 

INC 

SET.BAUD 

;Go to the next proopt if in bounds 

JMP 

INIT,i 

;e1se go ask again. 

Response 

vas in bounds, so proceed. 

SET BAUD: AND 

AL,0FH 

;Strip ASCII character to binary 

m 

AL 

;Adjust for desired bit pattern 

NOV 

CL,3 

;Rotate b0-b2 to b7-b5 

m 

AL,a 

; 

AND 

CWIGURATI(^,00011illB ;Reset b0~b5 of configuration byte 

OR 

CONFIGURATION,AL ;0R in bits. 

GET PARITY: 



CALL 

Cl^.SCI^ 

;C1ear screen and ask for 



;Parity. 

#CURSET 0,0,0 

;Set cursor top of screen 

»VDLINE MESSAGED 

;Ask Parity? 

fCRLF 



#VAITKEY 

;Get response 

AND 

AL,ii011111B 

;Reset bit 5, convert to 



;uppercase. 

CMP 

AL,'Y' 

;If yes, then continue 

INE 

SET_NONE 

;If not go to the next 



;proopt. 


EVEN OK): 
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RS232.IMT EMDP 


•tmmtmmmmmtmmmmttmmmmmtmtmmm 

;This is the initialization nodule which will pronpt the user for the 
;various paraneters required for connunicat ions. 

;This routine expects a dedicated area of RAN to be reserved for the 
;storage; CONFIGURATION. 

INIT PROG NEAR 
INITJ; 

CALL CLEAR^SCREEN ;C1ear the screen 

#CURSET 0,0,0 ;Set cursor to page 0, 

;row 0, colunn 0 

GET.BAUD: 


§VDLINE 

«CRLF 

NESSAGEl 

;A5k for baud rate 

»VDLINE 

«CRLF 

HESSAGE2 

;Show possible rates. 

9VDLINE 

RCRLF 

MESSAGES 


^VDLINE 

#CRLF 

NESSAGE4 


9VDLINE 

MESSAGES 


CALL 

CLEAR SCREEN 

;Cl ear the screen 

RCURSET 

0 ,0,0 

;Position the cursor 

«VDLINE 

RCRLF 

MESSAGE? 

;Ask even or odd parity? 

^NAITKEY 

;Get response 

AND 

AL,0FH 

;Na5k to binary 

CNP 

AL,1 

;Even? 

IE 

EV0I P 

;Then set it 

CNP 

AL,2 

;0dd? 

JNE 

SET^ODD: 

EVEN_0DD 

;lf neither 1 or 2 then 
;reask the question. 

AND 

CONFIGURATION,1110111 IB 

s? 

Ill 

cr 

OR 

CONFIGURATION,00001000B 

;And set bit 3 

IMP 

SHORT GET_STOPS 

;Go to the next pronpt 

EVEN^P; OR 

CONFIGURATION,0001lOOOB 

;Set both bits 4 and 3 

IMP 

SHORT GET.STOPS 

;Go to next pronpt 

SET.NONE: AND 

CONFIGURATION,1110011 IB ;Reset both bits 4 and 3 

GET.STOPS: 


;How nany stop bits? 

CALL 

CLEAR.SCREEN 


«CURSET 0,0,0 

;Position cursor 

#VDLINE NESSAGE8 

;Ask how nany 
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¥m 



eVDLIlE HESSAGE9 

;Sho« options 

#CRLF 



»¥AimEY 

;Get response 

AND 

AL^OFH 

;Strip to binary 

DEC 

AL 

;Vas the response a 'T? 

JZ 

ONE.STOP 

;Then setup 1 stop bit 

DEC 

AL 

;iF IT NAS NOT A '2' THEN 
;IffiASK THE <NJESTION. 

JNE 

GET.STOPS 


T¥0 STOPS: 



OR 

CONFIGURATION,OOOOOIOOB 

:Set bit 2 for 2 stop bits 

JHP 

SHORT ¥ORD.LENGTH ;Get word length 

ONE STOP: 



AND 

CONFIGURATION, in 1101 IB 

;Reset b2 for 1 stop bit 

V0RD.LEN6TH: 



CALL 

CLEAR.SCREEN 

;Clear the screen 

KURSET 0,0,0 

;Set the cursor 

eVDLINE HESSAGEIO 

;Ask word length 

#CRLF 



eVXINE HESSAGEil 

;Show options 

eCRLF 



tVDLINE HESSAGE12 


eCRLF 



WAITKEY 

;Get user response 

CNP 

AL/1' 

;7 bits? 

JZ 

SEVEN.UP 

; 

CMP 

AL/2' 

;If not 2 then reask the 
;guest ion. 

JNE 



EIGHT BITS: 



OR 

CONFIGURATION,00000011B 

;Set both bits 0 and 1 

JMP 

SH(»T TO.BCHO.®_NOT.TO ;Next question. 

^V0l UP: 



AND 

C(»IFI60RATI0N,lllini0B 

;Reset bit 0 

OR 

CONFIGURATION,00000010B 

;Set bit 1 

TO ECHO OR NOT TO; 


CMl 

CLEAR SOiEEN 

;Ask the next question. 

KURSET 0,0,0 

;Set the cursor position 

RVDLINE HESSAK30 

;Ask if the user wants 



;the characters typed locally 
;echoed to the screen. Used in 
;half duplex coenunicat ions. 

BCRLF 


;Next line 

BVAITKEY 

.:Vait for a Yes or No answer. 

AND 

AL,11011111B 

;Re5et bit 5, convert to upper case 

CMP 

AL,'Y' 

;Ybs? Then set bit 6 of 
:systee.status to reflect such. 

JNZ 

NO_ECHO 

;If not, then clear the bit. 

OR 

SYSTEM,STATUS,01000000B 

;Set bit 6 in response to Yes. 

JMP 

^ORT NE¥_LIIE.Q 

;Ask the next question. 
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NO.ECHO: 


AND 

SYSTEM.STATUS,101U111B 

;Reset bit A, no local echo. 

NEW.LINE.Q; 



CALL 

CLEAR.SCREEN 

;Clear the screen and set the cursor 

«CURSET 0,0,0 

; 

%WLm KCSSAGE31 

;Ask the question, do a CRLF 



;coibination on receipt of a CR? 

#CRLF 


; 

iiAITKEY 

;Vait for a Y or N 

AND 

AL,110111iiB 

;Convert to upper case 

CNP 

AL,'Y' 

;Yes? then set bit 7. Else clear bit 



;7 in SYSTOl^STATUS. 

JNZ 

NO.NEN.LINE 

;If not then reset the bit. 

OR 

SYSTEH.STATUS,i0000000B ;Ne« line function on. 

IMP 

SHORT SET.CONFIGURATION 

NO^NEN.LINE: 



AND 

SYSTEM,STATUS,01111111B 

;Reset the bit. 

SET_C0NFIGURATI0N: 


gRS232.INIT CONFIGURATION 

;Set the RS-232 port 

:.mmmmn 



;Now set a new RS-232 interrupt vector. 

Save the old. 

PUSH 

ES 

;Save extra seqeent value 

PUSH 

BX 

;And BX 

^READ„VECTOR OCH 

;Get the vector for 



;RS232 interrupts 

HOV 

WORD PTR 0LD_VBCT0R,BX 

;Save old vector 

NOV 

TORD PTR 0LD.VKIT0RC2],ES ;Save Old segient addr. 

POP 

BX 

^Retrieve BX and ES 

POP 

ES 

; 

LEA 

DX,RS232.INTJ 

;Get new offset 

PUSH 

DS 

;Save data segeent 

MOV 

AX,MY.C0DE 

;Segient of int. routine 

HOV 

DS,AX 

;Seg of int. routine 

HOV 

AL,0CH 

;Interrupt Type 

HOV 

AH,F.SET.INT^VECTOR 

^Function code 

INT 

21H 

;Go set new vector 

POP 

DS 

;Retrieve DS 

CLI 


;disable interrupts 

•Atmtmt 



;No« set RTS and DTR true, (logic 0). 


;Bit 3 oust be a to enable interrupts to the 8088. 

MOV 

AL,0000101IB 

;Set RTS, DTR, true and 



;enable interrupts (bit 3) 

MOV 

DX,JK)DD!.CONTR(L 

;Set up the oodee control register 

OUT 

DX,AL 



•Attmtmt 
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;Set up the serial board for receiver interrupts. 
;First clear any pending interrupts. 


HOV 

DX,LINE_STATUS 

;C1ear the line status int. 
;if any, by reading the 
;register (du«ey read) 

IN 

AL,DX 

;Neans nothing. 

NOV 

AL,0000000iB 

;Enable interrupts on 
tcoAi. board when received 
;character is ready. 

NOV 

DX,INTERRUPT^ENABLE 


OUT 

DX,AL 



;imm 

;No« set the 8259 to enable the desired interrupt types. 


NOV 

AL,10101lOOB 

;Enable disk, com, 

;keyboard, and tiier interrupts. 

OUT 

INT^C0NTR0L,AL 

;Send to 8259 

STI 


;Enable 8088 interrupts 

^RLF 


;Go to the next line 

8 VDLINE 

8 CRLF 

NESSAGE13 

;Show oessage that port «as set 

CALL 

DELAY 

;Leave eessage on the screen 
.!for awhile 

;and erase and show copyright 

call 

DELAY 


CALL 

DELAY 


CAiX 

CLEAR^SCRffiN 


ICURSET 

0 ,0,0 


BVDLINE 

#CRLF 

NESSAGE14 


RET 

ENDP 


;A11 done 


•mmmmmtttttmmtttmttmtmmmmttttttmttttt 

;Check bounds on the character in AL. If in bounds, reset carry, 
;if out of bounds, set the carry and return. 


NINMAX PROC 

NEAR 


CNP 

AL,HIN 

;If below, set the carry 

JB 

SET CARRY 


CNP 

AL,NAX 

;lf above, set the carry 

lA 

SET^CARRY 


CLC 


;Else clear the carry 

JHP 

SHORT DONE_HINNAX 


SET.CARRY: 

STC 
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DONE NINNAX: 

mnm endf 


^Procedure to clear the screen. 


CLEAR.SCRmi 

PROG NEAR 


pm 

AX 

;Siive registers 

Push 

BX 


PUSH 

CX 


PUSH 

DX 


BSCROLL 06,00,18H,4FH,00,00,07 

;Clear the screen 


;Restore registers 


POP DX 
POP CX 
POP BX 
POP AX 
RET 

CLEAR.SCREEN ENDP 

:nttitttnnnn%ttmnnnnnmttuntttm%uttt%tmu 


;Thi5 routine will provide a delay for a fixed duration, 
;all registers used are saved. 


DELAY PROC 

NEAR 

PUSH 

CX ;Save the registers 

HOV 

CX,7000H 

DaAYJ: LOOP 

DS-AYJ 

MOV 

CX,3000H 

DQ,AY_2: 

LOOP DELAY 2 

POP 

CX 

RET 

DELAY ENDP 

MY^CODE ENDS 


END 

START 
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AAA (ASCIIAdjust for Addition) 
instruction, 90, 328 
AAD (ASCII Adjust for Division) 
instruction, 101, 328 
AAM (ASCII Adjust for Multiplica¬ 
tion) instruction, 99, 328 
AAS (ASCII Adjust for Subtraction) 
instruction, 92, 328 
absolute disk access, 229, 243 
ACK (acknowledgement), 284 
acoustic coupler, 289 
ADC (add with carry) instruction, 88, 
329 

ADD (addition) instruction, 87, 329 
addition 
binary, 4 

binary coded decimal, 9 
hexadecimal, 8 

addition instructions 73, 87-91 
address bus, 51, 53 
address-object transfers, 72, 84 
addressing modes, 65-68 
time calculation and, 68 
AF (auxiliary carry flag), 61 
AH register, 20, 47 
AL register, 47 
ALE signal, 53 

ALU (Arithmetic Logic Unit), 46 
ampersand (&), 176,179 
amplitude modulation, 278 
analog data transmission, 276-278 
AND instruction, 102, 329 
AND operator, 167 
architecture 
defined, 43 

arithmetic instructions, 73, 87-102 
arithmetic operators, 167 
ASCII (American Standard Code for 
Information Exchange), 11, 
321 

communications and, 268 
conversion to binary system, 202 
assembler, xii, 21 
cross, 27 
format for, 136 
use of, 37 

ASSUME statement, 127,136 
asterisk (*) operator (multiplication), 
167 

asymmetric register, 59 
asynchronous communications, 282 
attribute operators, 162 
attributes for labels, 142 
auxiliary carry flag, 6l 
AX register, 47, 50 
POP instruction and, 79 

bandwidth, 278 
base pointer register, 59 
based indexing addressing, 66 
baud rate, 285 

baud rate divisor registers, 295 


Baudot code, 12, 321 
BCD (binary coded decimal system), 
9 

binary coded decimal system, 9 
binary system, 2-7 
conversion from ASCII to, 202 
conversion from decimal to, 198 
conversion to decimal, 202 
conversion to hexadecimal, 203 
BIOS (Basic Input/Output System), 
47, 249-264 

communications functions in, 303 
scroll function in, 233 
video functions in, 258 
bit, defined, 2 
BIU (Bus Interface Unit), 44 
bootstrap, 47 
bounds checking, 246 
BP (base pointer) register, 59 
BPS (bits per second), 285 
buffers, data, 309 
bus architecture, 51-55 
bus controller, 53 
byte, defined, 2 

calls, function, 182 
CALL instruction, 49, 50, 112-114, 
329 

carry flag, 60 

CBW (convert byte to word) instruc¬ 
tion, 98, 329 
CF (carry flag), 60 
characters, encoding of, 11 
CLC (clear carry)instruction, 131, 330 
CLD instruction, 330 
CLI (Clear Interrupt flag) instruction, 
132, 330 

clusters, defined, 210 
CMC (complement carry bit) instruc¬ 
tion, 131, 330 

CMP (compare) instruction, 94, 330 
CMPS (compare string)instructions, 
127, 330 

code segment, programming and, 
192, 233 

code segment register, 49 
colon suffix, 29 
color character attributes, 255 
color combinations, 256 
color/graphics adapter, 254 
COMM.ASM program, 443 
comment field in source statement, 
31 

COMMENT pseudo-op, 148 
communications, 267-318 
asynchronous, 282 
data transmission methods and, 
270 

computer to computer, 291 
error checking in, 285 
errors in, 300 
parallel, 270 


parameters for, 305 
program for, 292-302, 305-317 
protocols for, 268 
RAM and, 118 
serial, 271 
synchronous, 283 
compiled languages, 19 
computer languages, types of, 17-21 
conditional pseudo-ops, 155-158 
conditional transfer instructions, 74, 
115-119 

CONFIGSY.ASM program, 355 
CONFIGSY.LST program, 361 
control bus, 51 
control signals, 51 
copying files, 238-243 
CPU (Central Processing Unit), 17 
defined, 43 

memory management and, 46 
.CREF pseudo-op, 159,160 
cross assemblers, 27 
cross reference file, 38, 40 
CS register, 58 

C WD (convert word to double word) 
instruction, 98, 331 

DAA (Decimal Adjust for Addition) 
instruction, 90, 331 
DAS (Decimal Adjust for Subtraction) 
instruction, 93, 331 
data buffers, 309 
data bus, 51, 53 
data pseudo-ops, 136-140 
data register, 59 

data segment, programming and, 

192 , 232 

data storage, memory and, 47 
data transfer instructions, 72, 75-87 
general purpose, 76-82 
data transmission methods, 270 
analog, 276 
DB pseudo-op, 141 
DD pseudo-op, I4l 
DEC (decrement) instruction, 94, 331 
decimal system, 2 
conversion from binary, 202 
conversion to binary, 7,198 
conversion to hexadecimal, 198 
definitions, programming and, 194 
DEN signal, 53 
destination operand, 71 
DF (direction flag), 63 
dibit phase encoding, 277 
direction flag, 63 
directory in MS-DOS, 214 
format of, 215 

DIRREAD.ASM program, 426 
disk access, absolute, 229 
disk buffer, programming and, 232 
disk drives, 210 
disk I/O, 207-247 
MS-DOS functions and, 207-208 

475 
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disk sectors, 230 
disk transfer address (DTA), 220 
diskette, 209 
capacities of, 211 
displacement addressing, 67 
displaying data, 204 
distance attribute, 143,165 
DIV instruction, 99, 331 
division instructions, 73, 99-102 
DLOAD.ASM program, 447 
documentation, comment field and, 
31 

dollar sign ($), 148 
DOSEQU.EQU program, 396 
downloading files, 317 
DQ pseudo-op, l4l 
DRAM (Dynamic Random Access 
Memory), 46 
drawing lines, 260 
DS operator, 165 
DT pseudo-op, l4l 
dummy arguments, 170 
DUP pseudo-op, I4l 
duplex, 269 

DURATION of sound, 263 
DW pseudo-op, l4l 

8086 microprocessor, 53 
instruction set for, 327-345. See 
also name of instruction 
8088 microprocessor 
architecture of, 55 
instruction set for, 71-134, 
327-345. See also name of 
instruction 

interrupts and, 63,123 
segmentation of, 56 
8288 bus controller, 53 
EBCDIC code, 12, 321 
editor, 23 

electrical pacing, 294 
ELSE pseudo-op, 157 
END pseudo-op, 155 
ENDIF pseudo-op, 157 
ENDM pseudo-op, 175 
ENDP pseudo-op, 139 
ENDS pseudo-op, 138 
ENDS pseudo-op, 152 
EQ operator, 166 
EQU (equate) pseudo-op, 145 
equal (=) pseudo-op, 145 
equates, programming and, 194 
erasing lines, 262 

error checking in communications, 
269, 285-288 

error codes for absolute disk I/O, 231 
errors in programming, 237 
ES operator, I65 

ESC (escape) instruction, 133, 

331 

EU (Execution Unit), 44 

EVEN pseudo-op, 150 

exchange (XCHG) instruction, 82, 

343 

exclamation point (!), 176 


exclusive OR (XOR) instruction, 105, 

345 

EXITM pseudo-op, 175,178 
expressions, I66 
extensions, signed, 97 
external mask interrupt (INT) 
instruction, 333 

external synchronization, 75, 

132-134 

EXTRN pseudo-op, 147 

FAR procedure, defined, 113 
FAST—CPY.ASM program, 421 
fields, 28-32 
comment, 31 
label, 29 
op-code, 30 
operand, 31 
file 

access to, 221-229 
closing of, 226, 229 
created with assembler, 38-40 
creation, 221, 228 
opening of, 227, 235 
file allocation table, 213 
file control blocks (FCB), 217 
formats of, 218 
programming and, 233 
specifying, 219 
file handles, 226 
flag operations, 75,131-132 
flag register, 45,60 
flag register transfers, 72, 86 
flow chart 

programming techniques and, 190 
source code and, 34-37 
symbols used in, 33 
FOR statement, 119 
format for assembler, 136 
forward references, 26 
framing error, 300 
frequency modulation, 277 
FREQUENCY of sound, 263 
FSK (frequency shift keying), 277, 
285, 288 

full duplex, 269, 278 
full screen editor, 23 
function calls, 182 

GE operator, I66 
GRAPHIC.ASM program, 435 
graphics, 254, 256-263 
GROUP pseudo-op, 154 
GT operator, 166 

half duplex, 269, 280 
hardware requirements, xii 
hexadecimal system, 7, 321 
conversion from binary to, 203 
conversion from decimal to, 198 
high level languages, 18 
high resolution graphics mode, 257 
HIGH operator, 164 
HLT (Halt) instruction, 132, 332 

IBM PC memory map, 55, 57 
IDIV (Integer Divide) instruction, 

100,332 


IF (interrupt flag), 62 
IF pseudo-ops, 157 
immediate addressing, 65 
immediate operand, 72 
IMUL (Integer Multiply) instruction, 
97,332 

IN instruction, 83, 332 
INC (increment) instruction, 89, 332 
INCLUDE pseudo-op, 153 
macros and, 173 
index register, 59 
initialization of programs, 195 
instruction pointer, 45, 49, 58 
INT instruction, 122, 333 
interpretive languages, 18 
interrupts, 63, 74, 121-124. See also 
name of interrupt 
interrupt controller, 301 
interrupt enable register, 298 
interrupt flag, 62 

interrupt identification register, 298 
interrupt service routine, 307, 309 
interrupt vectors, 123 
INTO instruction, 124, 333 
INTR (external mask interrupt) 
instruction, 333 
I/O (input/output), 50 
disk, 204-247 

IRET (interrupt return) instruction, 
50,124, 333 
IRP pseudo-op, 175,177 
IRPC pseudo-op, 175,177 
iteration control instructions, 74, 

119-121 

JCXZ instruction, 121, 334 
JMP instruction, 30, 31,114 
Jump if... instructions, II6, 333-336 

keyboard buffer, programming and, 

232 

KEYDSP program, 399 
label field, 29 

labels for numerical values, 23-26, 
142 

local, 173 
syntax for, 29 
LABEL pseudo-op, 146 
LAHF (load register AH from flags) 
instruction, 86, 336 
.LALL pseudo-op, 159,160 

languages, types of, 17-21 
LDS (load pointer using DS) instruc¬ 
tion, 85, 336 
LE operator, I66 

LEA (load effective address) instruc¬ 
tion, 84,336 
LENGTH operator, 144 
LES (load pointer using ES) instruc¬ 
tion, 85,336 

LFCOND pseudo-op, 159, l6l 
line control register, 296 
line drawing, 260 
line status register, 299 
linkers, 27 
use of, 38 
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SCAS (Scan String) instructions, 128, 
342 

scroll function in BIOS, 233 
SDLC protocol, 284 
segment attribute for labels, 142 
segment override operators, 165, 342 
segment register, 56 
SEGMET pseudo-op, 138 
segmented memory, 58 
programming and, 193 
semi-colon (;), 176 
sequential file access, 221 
serial I/O functions, 251 
serial board port assignments, 273, 
295 

serial data transmission, 271 
SF (sign flag), 62 
.SFCOND pseudo-op, 159, l6l 
shift instructions, 73,107-110 
SHL (Shift Logical Left) instruction, 
109, 342 

SHL operator, l67 
SHORT operator, 165 
SHR (Logical Shift Right) instruction, 
109 

SHR operator, 167 
sign extensions, 97 
sign flag, 62 
simplex, 269, 281 
SINGLE STEP interrupt, 343 
SIZE operator, 144 
slash (/) operator (division), 167 
sorting, 244 
sound generation, 263 
SOUND.ASM program, 440 
source code 

creation of, 28-32 


defined, xii 

flow charting and, 34-47 
SP (stack pointer) register, 59 
spooling, 315 
SS operator, 165 
stacks, 48 

stack pointer, 45, 48 
stack pointer register, 59 
stack segment, programming and, 
192, 233 
status flags, 60 
status register, 45 

STC (set carry) instruction, 131, 343 
STD (set direction flag) instruction, 
343 

STI (Set Interrupt flag)instruction, 
132, 343 

STOS (Store String) instructions, 130, 

343 

string instructions, 74,124-130 

STRUG pseudo-op, 152 

SUB (subtraction) instruction, 91, 

344 

subroutines, 48 
subtraction, binary, 5 
subtraction instructions, 73, 91-95 
SUBTTL pseudo-op, 159 
symbolic representation for numer¬ 
ical values, 23-26 
SYN control code, 283 
synchronous communications, 283 
syntax of source statement, 28-32 

TANDY 2000 MS-DOS, 250 
telecommunications, 272-276 
frequency assignments for, 276 
TEST instruction, 106, 344 
.TFCOND pseudo-op, 159, l6l 


THIS operator, 164 
THR (transmitter holding register), 
297 

TITLE pseudo-op, 159, l6l 
TR (trap flag), 62 

translate (XLAT) instruction, 82, 344 
transmitting characters function, 
303 

via BIOS, 304 
trap flag, 62 
tree structures, 227 
type attribute for labels, 143 
type zero interrupt, 99 

UART (Universal Asynchronous 
Receiver Transmitter), 272 
unconditional transfer instructions, 
74,112-115 

video I/O, 253 

WAIT instruction, 132, 344 
word, defined, 2 
WR signal, 51 
writing blocks, 225 
writing files, 222 
writing records, 224 

.XALL pseudo-op, 159,160 
XCHG (exchange) instruction, 82 
XLAT (translate) instruction, 82 
.XLIST pseudo-op, 159 
XON/XOFF, 12 

XOR (exclusive OR) instruction, 105, 
345 

XOR operator, 167 
.XREF pseudo-op, 159,160 

ZF (zero flag), 46, 61 
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.LIST pseudo-op, 159 
listing file, 39 
listing pseudo-ops, 158 
local labels, 173 
LOCAL pseudo-op, 173 
LOCK prefix, 133,337 
LODS (Load String) instructions, 129, 
337 

logic instructions, 73,102-107 
logical disk sectors, 230 
logical operators, 167 
Logical Shift Right (SHR) instruction, 
109, 343 

LOOP instructions, 119,127, 337 
LOW operator, 164 
LSB (least significant bit), defined, 3 
LT operator, 166 

MACFLE.MAC program, 369 
machine code, xiii 
machine language, 19 
macro definitions, 169 
MACRO pseudo-op, 175 
maskable interrupts, 64 
maximum mode control signals, 51 
medium resolution graphics mode, 
256 

memory, 46 
addressing of, 56 
mapof, 55, 57 
segmentation of, 47, 56 
memory direct addressing, 65 
with index, 66 
memory refresh, 46 
messages, programming and, 193, 
233 

microprocessors, 17 
minimum mode control signals, 51 
minus sign (-) operator, 167 
M/IO signal, 51 
mnemonics, 22, 30 
MOD operator, 167 
modems, 288-292 
modem control register, 297 
modem status register, 300 
monochrome character attributes, 
253 

MOV instruction, 17, 20, 31, 76, 338 
MOVS (move string) instructions, 
126 , 338 

MS-DOS, 181-188 
directory structure of, 214 
disk functions in, 207 
disk map of, 212 
file access in, 221-229 
programming tools in, 213-221 
RS-232C functions in, 302 
serial I/O in, 293 
MS-DOS function, 219 
MSB (most significant bit), defined, 3 
MUL instruction, 96, 338 
multiplication indicators, 62 
multiplication instructions, 73, 
95-99 

NAK (negative acnowledgement), 
284 


NAME pseudo-op, 153 
names, symbolic, 142 
NE operator, 166 
NEAR procedure, defined, 113 
NEG (negate) instruction, 94, 33 
NEW—COPY program, 4l6 
NEW—TYPE.ASM program, 412 
NEXT statement, 119 
nibble, defined, 8 
NMI interrupt, 64, 337 
no operation instruction, 75, 131, 
339 

noise on line, 285 
nonmaskable interrupt, 64 
NOT instruction, 107, 339 
NOT operator, 167 
null cable, 291 

number conversions, program for, 
189-205 

numbering systems, 2-13 
program fr conversions of, 
189-205 

NUMBERSY.ASM program, 401 

object file, 39 
OF (overflow flag), 62 
OFFSET attribute for labels, 143 
op-codes, 30 
operands, 31 
destination, 71 
operating systems, 181-188 
operators, 162-168. See also name of 
operator 

OR instruction, 105, 339 
OR operator, 167 
ORG pseudo-op, 148 
OUT instruction, 83, 339 
%OUT pseudo-op, 159 
overflow flag, 62 
overrun error, 300 

PAGE pseudo-op, 19, l6l 

parallel data transmission, 270 
parity, 287 
parity error, 300 
parity flag, 6l 
parsing a string, 235 
pathnames, 227 
percentage sign (%), 176,180 
PF (parity flag), 61 
phase modulation, 277 
physicaldisk sectors, 230 
pipelining, 44 
pixel positioning, 257 
plus sign (-H) operator, 167 
pointer register, 59 
pointers, 45 

POP instruction, 50, 78, 339 
POPF instruction, 86, 340 
port addresses, 25 
IN and OUT instruction and, 83 
port assignments, serial board, 273, 
295 

power bus, 51 
printer I/O, 252 
PROC pseudo-op, 139 
procedures, 48 


processor control instructions, 75, 
130-134 

program segment prefix (PSP), 
215-217 

program transfer instructions, 74, 
112-124 

programmer, 16 

programming techniques, 189-205 
BIOS and, 259-263 
disk I/O and, 207-247 
protocols for communications, 268 
pseudo-ops, 136-140, 145-162. See 
also name of pseudo-op 
PTR (pointer) operator, 162 
PUBLIC pseudo-op, 147 
PURGE pseudo-op, 175,176 
PUSH instruction, 50, 78, 340 
PUSHF (push flags) instruction, 86, 

340 

.RADIX pseudo-op, 154 
RAM (Random Access Memory), 46 
communications and, 118 
random block access, 224 
random record access, 223 
RCL (Rotate through Carry Left) 
instruction. 111, 340 
RCR (Rotate through Carry Right) 
instruction. 111, 340PRD sig¬ 
nal, 51 

reading blocks, 225 
reading files, 222 
reading records, 223, 236 
receive function, 302 
via BIOS, 304 
RECORD pseudo-op, 150 
registers, 43, 44. See also name of 
register 
specialized, 45 
register direct addressing, 65 
register indirect addressing, 66 
with displacement addressing, 67 
relational operators, 166 
REP instructions, 125, 340-341 
REPT pseudo-op, 175,176 
RET instruction, 49,112-114, 31 
POP instructions and, 79 
RHR (receiver holding register), 297 
ROL (Rotate Left) instruction, 110, 

341 

ROM (Read Only Memory), 46 
ROR (Rotate Right) instruction, 110, 
341 

rotate instructions, 73,110 
RS-232C, 251,289 
signal and pin assignments for, 
290, 291 

SAHF (store register AH into flags) 
instruction, 86, 341 
SAL (Shift Arithmetic Left) instruc¬ 
tion, 107-109, 342 
.SALL pseudo-op, 159,160 
SAR (Shift Arithmetic Right) instruc¬ 
tion, 107, 342 

SBB (subtract with borrow) instruc¬ 
tion, 92,342 



Source Code Offer 


Gary A. Shade has made available to interested readers the complete source code 
for every programming example used in his book 808B IBM PC Assembly Lan¬ 
guage Programming. 

Why spend hours entering the source examples found in this book when you can 
order the source code on IBM PC compatible media? The entire source code for the 
macro library found in Chapter 6 is worth the price of the diskette alone. You can 
use the macro library in each and every one of your own programs—use routines 
from any of the examples included in your own programs with no royalties to pay! 

To order: 

Include $29-95 money order, certified check, or personal check (*). Mail your 
check (made payable to Argonaut Systems) and the form below to: 

Argonaut Systems 
POB 2492 

Northbrook, IL 60065 


Send me the complete source library to “8088 IBM PC Assembly Language Pro¬ 
gramming” by Gary A. Shade. I have enclosed a certified check, money order or 
personal check for $29.95 made payable to Argonaut Systems. 

Name_____ 

Address_ 

City___ 

State_Zip_ 


Allow 3-4 weeks for delivery. Personal checks - allow 4-5 weeks for delivery. 
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The Nuts ‘N Bolts 

of Assembly Language Programming 


Professionals and hobbyists! Whether you’re a serious computer 
user or just love to tinker with your PC, this guide shows you the 
best ways to attack Assembly Language programming. 

You’ll get a step-by-step introduction to microprocessors . . . 
numbering systems . . . and character encoding to give you the 
boost you need to get the most out of ALP. 

And that’s not all! The book covers MS DOS function calls and 
features number conversion charts . . . ASCII and BAUDOT 
character encoding charts . . . and a complete set of original Intel 
Corporation data sheets! 








